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
SEC_E_INVALID_HANDLE	O identificador que foi passado para a função não é válido.
SEC_E_INVALID_TOKEN	O token que foi passado para a função não é válido.
SEC_E_OUT_OF_SEQUENCE	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.
SEC_E_MESSAGE_ALTERED	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.
SEC_E_INTERNAL_ERROR	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