Función CompleteAuthToken (sspi.h)

La función CompleteAuthToken completa un token de autenticación. Esta función la usan los protocolos, como DCE, que necesitan revisar la información de seguridad después de que la aplicación de transporte haya actualizado algunos parámetros de mensaje.

Esta función solo es compatible con el proveedor de compatibilidad de seguridad implícita (SSP).

CompleteAuthToken solo se usa en el lado servidor.

Sintaxis

SECURITY_STATUS SEC_ENTRY CompleteAuthToken(
  [in] PCtxtHandle    phContext,
  [in] PSecBufferDesc pToken
);

Parámetros

[in] phContext

Identificador del contexto que debe completarse.

[in] pToken

Puntero a una estructura SecBufferDesc que contiene el descriptor de búfer para todo el mensaje.

Valor devuelto

Si la función se ejecuta correctamente, la función devuelve SEC_E_OK.

Si se produce un error en la función, devuelve uno de los siguientes códigos de error.

Código devuelto	Descripción
SEC_E_INVALID_HANDLE	El identificador que se pasó a la función no es válido.
SEC_E_INVALID_TOKEN	El token que se pasó a la función no es válido.
SEC_E_OUT_OF_SEQUENCE	Se ha localizado el contexto de seguridad del cliente, pero el número de mensaje es incorrecto. Este valor devuelto se usa con el SSP de resumen.
SEC_E_MESSAGE_ALTERED	Se ha localizado el contexto de seguridad del cliente, pero el mensaje del cliente se ha alterado. Este valor devuelto se usa con el SSP de resumen.
SEC_E_INTERNAL_ERROR	Error que no se asignación a un código de error de SSPI.

Comentarios

El cliente de una aplicación de transporte llama a la función CompleteAuthToken para permitir que el paquete de seguridad actualice una suma de comprobación o una operación similar después de que la aplicación de transporte haya actualizado todos los encabezados de protocolo. El cliente llama a esta función solo si la llamada InitializeSecurityContext (Digest) devuelta SEC_I_COMPLETE_NEEDED o SEC_I_COMPLETE_AND_CONTINUE.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	sspi.h (include Security.h)
Library	Secur32.lib
Archivo DLL	Secur32.dll

Consulte también

InitializeSecurityContext (Digest)

Funciones SSPI

SecBufferDesc