Edit

Share via

WS_CERT_ISSUER_LIST_NOTIFICATION_CALLBACK callback function (webservices.h)

  • Article

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.

Syntax

WS_CERT_ISSUER_LIST_NOTIFICATION_CALLBACK WsCertIssuerListNotificationCallback;

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

Parameters

[in] certIssuerListNotificationCallbackState

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

[in] issuerList

The list of certificate issuers acceptable to the server.

[in, optional] error

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

Return value

This callback function does not return a value.

Requirements

Requirement Value
Minimum supported client Windows 7 [desktop apps only]
Minimum supported server Windows Server 2008 R2 [desktop apps only]
Target Platform Windows
Header webservices.h