WS_GET_CERT_CALLBACK Rückruffunktion (webservices.h)

  • Artikel

Stellt ein Zertifikat für die Security Runtime bereit. Dieser Rückruf wird als Teil des WS_CUSTOM_CERT_CREDENTIAL angegeben, der wiederum als Teil einer Sicherheitsbindung angegeben werden kann, für die Zertifikatanmeldeinformationen erforderlich sind. Die Runtime ruft diesen Rückruf auf, wenn der Kanal (clientseitig) oder der Listener (serverseitig) geöffnet wird.

Zertifikatbesitz: Wenn dieser Rückruf ein erfolgreiches HRESULT zurückgibt, übernimmt der Aufrufer (nämlich die Sicherheitslaufzeit) den Besitz des zurückgegebenen Zertifikats und gibt es frei, wenn der enthaltende Kanal es nicht mehr benötigt. Wenn dieser Rückruf ein Fehler-HRESULT zurückgibt, übernimmt der Aufrufer NICHT den Besitz des werts, der im Out-Parameter "cert" zurückgegeben wird.

Syntax

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
)
{...}

Parameter

[in] getCertCallbackState

Zustand, der zusammen mit diesem Rückruf in den Zertifikatanmeldeinformationen angegeben wurde.

[in, optional] targetAddress

Die Zieladresse, der dieses Zertifikat vorgelegt werden soll, falls diese Zertifikatanmeldeinformationen für einen Client angegeben werden.

[in, optional] viaUri

Die Via-Adresse, an die dieses Zertifikat vorgelegt werden soll.

cert

Der Speicherort, an dem das Zertifikat zurückgegeben werden soll.

[in, optional] error

Gibt an, wo zusätzliche Fehlerinformationen gespeichert werden sollen, wenn die Funktion fehlschlägt.

Rückgabewert

Diese Rückruffunktion gibt keinen Wert zurück.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile webservices.h