Leggere in inglese

Condividi tramite


WS_GET_CERT_CALLBACK funzione di callback (webservices.h)

Fornisce un certificato al runtime di sicurezza. Questo callback viene specificato come parte del WS_CUSTOM_CERT_CREDENTIAL, che a sua volta può essere specificato come parte di un'associazione di sicurezza che richiede credenziali del certificato. Il runtime richiamerà questo callback quando viene aperto il canale (lato client) o il listener (lato server).

Proprietà del certificato: se questo callback restituisce un valore HRESULT riuscito, il chiamante (ovvero il runtime di sicurezza) assumerà la proprietà del certificato restituito e lo libererà quando il canale contenitore non ne ha più bisogno. Se questo callback restituisce un valore HRESULT non riuscito, il chiamante NON assumerà la proprietà o addirittura esaminerà, il valore restituito nel parametro out 'cert'.

Sintassi

WS_GET_CERT_CALLBACK WsGetCertCallback;

HRESULT WsGetCertCallback(
  [in]           void *getCertCallbackState,
  [in, optional] const WS_ENDPOINT_ADDRESS *targetAddress,
  [in, optional] const WS_STRING *viaUri,
                 const _CERT_CONTEXT **cert,
  [in, optional] WS_ERROR *error
)
{...}

Parametri

[in] getCertCallbackState

Stato specificato insieme a questo callback nelle credenziali del certificato.

[in, optional] targetAddress

Indirizzo di destinazione a cui deve essere presentato il certificato, nel caso in cui questa credenziale del certificato venga specificata per un client.

[in, optional] viaUri

Indirizzo via a cui deve essere presentato il certificato.

cert

Percorso in cui restituire il certificato.

[in, optional] error

Specifica dove archiviare informazioni aggiuntive sull'errore se la funzione ha esito negativo.

Valore restituito

Questa funzione di callback non restituisce un valore.

Requisiti

Requisito Valore
Client minimo supportato Windows 7 [solo app desktop]
Server minimo supportato Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione webservices.h

Risorse aggiuntive