Skip to content

Latest commit

 

History

History
87 lines (70 loc) · 3.23 KB

nc-webservices-ws_cert_issuer_list_notification_callback.md

File metadata and controls

87 lines (70 loc) · 3.23 KB
Raw
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NC:webservices.WS_CERT_ISSUER_LIST_NOTIFICATION_CALLBACK
WS_CERT_ISSUER_LIST_NOTIFICATION_CALLBACK (webservices.h)
Notifies the client of the list of certificate issuers that are acceptable to the server.
WS_CERT_ISSUER_LIST_NOTIFICATION_CALLBACK
WS_CERT_ISSUER_LIST_NOTIFICATION_CALLBACK callback
WS_CERT_ISSUER_LIST_NOTIFICATION_CALLBACK callback function [Web Services for Windows]
webservices/WS_CERT_ISSUER_LIST_NOTIFICATION_CALLBACK
wsw.ws_cert_issuer_list_notification_callback
wsw\ws_cert_issuer_list_notification_callback.htm
wsw
a8417d3f-5932-4993-b206-b43b6a93ef8f
12/05/2018
WS_CERT_ISSUER_LIST_NOTIFICATION_CALLBACK, WS_CERT_ISSUER_LIST_NOTIFICATION_CALLBACK callback, WS_CERT_ISSUER_LIST_NOTIFICATION_CALLBACK callback function [Web Services for Windows], webservices/WS_CERT_ISSUER_LIST_NOTIFICATION_CALLBACK, wsw.ws_cert_issuer_list_notification_callback
webservices.h
Windows
Windows 7 [desktop apps only]
Windows Server 2008 R2 [desktop apps only]
Windows
19H1
WS_CERT_ISSUER_LIST_NOTIFICATION_CALLBACK
webservices/WS_CERT_ISSUER_LIST_NOTIFICATION_CALLBACK
c++
APIRef
kbSyntax
UserDefined
WebServices.h
WS_CERT_ISSUER_LIST_NOTIFICATION_CALLBACK

WS_CERT_ISSUER_LIST_NOTIFICATION_CALLBACK callback function

-description

Notifies the client of the list of certificate issuers that are acceptable to the server. With some protocols such as SSL, the server may optionally send such an issuer list to help the client choose a certificate.

This callback is an optional part of the WS_CUSTOM_CERT_CREDENTIAL.
If the (possibly NULL) certificate returned by the WS_GET_CERT_CALLBACK is accepted by the server, then this callback is never invoked. If the server rejects it and sends back an issuer list, then this callback will be invoked. The client may then choose a certificate based on the issuer list and supply that certificate when the channel is opened next and WS_GET_CERT_CALLBACK is invoked again.

The parameters supplied during this callback are valid only for the duration of the callback.

-parameters

-param certIssuerListNotificationCallbackState [in]

State that was specified along with this callback in the WS_CUSTOM_CERT_CREDENTIAL.

-param issuerList [in]

The list of certificate issuers acceptable to the server.

-param error [in, optional]

Specifies where additional error information should be stored if the function fails.

-returns

This callback function does not return a value.