Compartilhar via


Método IWSDSSLClientCertificate::GetMappedAccessToken (wsdbase.h)

Obtém o token de acesso mapeado.

Sintaxe

HRESULT GetMappedAccessToken(
  [in, out] HANDLE *phToken
);

Parâmetros

[in, out] phToken

Um identificador para o token de acesso mapeado. Após a conclusão, o chamador deve liberar o identificador chamando CloseHandle.

Retornar valor

Os valores retornados possíveis incluem, mas não se limitam a, o seguinte.

Código de retorno Descrição
S_OK
O método foi bem-sucedido.
S_FALSE
O token associado ao identificador especificado não está disponível.

Comentários

Se o certificado do cliente tiver sido mapeado com êxito para uma conta de usuário do sistema operacional, um token de acesso válido para esse usuário será retornado por meio do phToken. Esse token pode ser usado para representar o usuário. Internamente, HTTP.sys fará o mapeamento do certificado do cliente para a conta de usuário e retornará essas informações por meio da estrutura HTTP_SSL_CLIENT_CERT_INFO .

Requisitos

Requisito Valor
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 wsdbase.h (include Wsdapi.h)
DLL Wsdapi.dll

Confira também

IWSDSSLClientCertificate