Compartir a través de

Función CompleteAuthToken (sspi.h)

  • Artículo

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