Função CompleteAuthToken (sspi.h)
A função CompleteAuthToken conclui um token de autenticação. Essa função é usada por protocolos, como DCE, que precisam revisar as informações de segurança depois que o aplicativo de transporte tiver atualizado alguns parâmetros de mensagem.
Essa função tem suporte apenas pelo SSP ( provedor de suporte de segurança ) Digest.
CompleteAuthToken é usado apenas no lado do servidor.
Sintaxe
SECURITY_STATUS SEC_ENTRY CompleteAuthToken(
[in] PCtxtHandle phContext,
[in] PSecBufferDesc pToken
);
Parâmetros
[in] phContext
Um identificador do contexto que precisa ser concluído.
[in] pToken
Um ponteiro para uma estrutura SecBufferDesc que contém o descritor de buffer para toda a mensagem.
Retornar valor
Se a função for bem-sucedida, a função retornará SEC_E_OK.
Se a função falhar, ela retornará um dos seguintes códigos de erro.
Código de retorno | Descrição |
---|---|
|
O identificador que foi passado para a função não é válido. |
|
O token que foi passado para a função não é válido. |
|
O contexto de segurança do cliente foi localizado, mas o número da mensagem está incorreto. Esse valor retornado é usado com o SSP do Digest. |
|
O contexto de segurança do cliente foi localizado, mas a mensagem do cliente foi adulterada. Esse valor retornado é usado com o SSP do Digest. |
|
Ocorreu um erro que não foi mapeado para um código de erro SSPI. |
Comentários
O cliente de um aplicativo de transporte chama a função CompleteAuthToken para permitir que o pacote de segurança atualize uma soma de verificação ou uma operação semelhante depois que todos os cabeçalhos de protocolo forem atualizados pelo aplicativo de transporte. O cliente chamará essa função somente se a chamada InitializeSecurityContext (Digest) retornar SEC_I_COMPLETE_NEEDED ou SEC_I_COMPLETE_AND_CONTINUE.
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
Plataforma de Destino | Windows |
Cabeçalho | sspi.h (inclua Security.h) |
Biblioteca | Secur32.lib |
DLL | Secur32.dll |