Compartilhar via


WS_CERT_ISSUER_LIST_NOTIFICATION_CALLBACK função de retorno de chamada (webservices.h)

Notifica o cliente da lista de emissores de certificado que são aceitáveis para o servidor. Com alguns protocolos, como SSL, o servidor pode, opcionalmente, enviar essa lista de emissores para ajudar o cliente a escolher um certificado.

Esse retorno de chamada é uma parte opcional do WS_CUSTOM_CERT_CREDENTIAL.
Se o certificado (possivelmente NULL) retornado pelo WS_GET_CERT_CALLBACK for aceito pelo servidor, esse retorno de chamada nunca será invocado. Se o servidor rejeitá-lo e enviar de volta uma lista de emissores, esse retorno de chamada será invocado. Em seguida, o cliente pode escolher um certificado com base na lista de emissores e fornecer esse certificado quando o canal for aberto em seguida e WS_GET_CERT_CALLBACK for invocado novamente.

Os parâmetros fornecidos durante esse retorno de chamada são válidos apenas pela duração do retorno de chamada.

Sintaxe

WS_CERT_ISSUER_LIST_NOTIFICATION_CALLBACK WsCertIssuerListNotificationCallback;

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

Parâmetros

[in] certIssuerListNotificationCallbackState

Estado especificado junto com esse retorno de chamada no WS_CUSTOM_CERT_CREDENTIAL.

[in] issuerList

A lista de emissores de certificado aceitável para o servidor.

[in, optional] error

Especifica onde informações adicionais de erro devem ser armazenadas se a função falhar.

Valor retornado

Essa função de retorno de chamada não retorna um valor.

Requisitos

   
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho webservices.h