Freigeben über

WS_CERT_ISSUER_LIST_NOTIFICATION_CALLBACK Rückruffunktion (webservices.h)

  • Artikel

Benachrichtigt den Client über die Liste der Zertifikataussteller, die für den Server akzeptabel sind. Bei einigen Protokollen wie SSL kann der Server optional eine solche Ausstellerliste senden, um dem Client bei der Auswahl eines Zertifikats zu helfen.

Dieser Rückruf ist ein optionaler Bestandteil der WS_CUSTOM_CERT_CREDENTIAL.
Wenn das vom WS_GET_CERT_CALLBACK zurückgegebene Zertifikat (möglicherweise NULL) vom Server akzeptiert wird, wird dieser Rückruf nie aufgerufen. Wenn der Server dies ablehnt und eine Ausstellerliste zurücksendet, wird dieser Rückruf aufgerufen. Der Client kann dann basierend auf der Ausstellerliste ein Zertifikat auswählen und dieses Zertifikat bereitstellen, wenn der Kanal als Nächstes geöffnet wird und WS_GET_CERT_CALLBACK erneut aufgerufen wird.

Die während dieses Rückrufs angegebenen Parameter sind nur für die Dauer des Rückrufs gültig.

Syntax

WS_CERT_ISSUER_LIST_NOTIFICATION_CALLBACK WsCertIssuerListNotificationCallback;

HRESULT WsCertIssuerListNotificationCallback(
  [in]           void *certIssuerListNotificationCallbackState,
  [in]           const _SecPkgContext_IssuerListInfoEx *issuerList,
  [in, optional] WS_ERROR *error
)
{...}

Parameter

[in] certIssuerListNotificationCallbackState

Zustand, der zusammen mit diesem Rückruf im WS_CUSTOM_CERT_CREDENTIAL angegeben wurde.

[in] issuerList

Die Liste der Zertifikataussteller, die für den Server zulässig sind.

[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

   
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