Funzione CompleteAuthToken (sspi.h)

Articolo
03/02/2024

La funzione CompleteAuthToken completa un token di autenticazione. Questa funzione viene usata dai protocolli, ad esempio DCE, che devono rivedere le informazioni di sicurezza dopo che l'applicazione di trasporto ha aggiornato alcuni parametri del messaggio.

Questa funzione è supportata solo dal provider di supporto per la sicurezza digest .

CompleteAuthToken viene usato solo sul lato server.

Sintassi

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

Parametri

[in] phContext

Handle del contesto che deve essere completato.

[in] pToken

Puntatore a una struttura SecBufferDesc che contiene il descrittore del buffer per l'intero messaggio.

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce SEC_E_OK.

Se la funzione ha esito negativo, restituisce uno dei codici di errore seguenti.

Codice restituito	Descrizione
SEC_E_INVALID_HANDLE	L'handle passato alla funzione non è valido.
SEC_E_INVALID_TOKEN	Il token passato alla funzione non è valido.
SEC_E_OUT_OF_SEQUENCE	Il contesto di sicurezza del client si trovava, ma il numero del messaggio non è corretto. Questo valore restituito viene usato con il provider di servizi condivisi digest.
SEC_E_MESSAGE_ALTERED	Il contesto di sicurezza del client si trovava, ma il messaggio del client è stato manomesso. Questo valore restituito viene usato con il provider di servizi condivisi digest.
SEC_E_INTERNAL_ERROR	Si è verificato un errore che non è stato mappato a un codice di errore SSPI.

Commenti

Il client di un'applicazione di trasporto chiama la funzione CompleteAuthToken per consentire al pacchetto di sicurezza di aggiornare un checksum o un'operazione simile dopo che tutte le intestazioni del protocollo sono state aggiornate dall'applicazione di trasporto. Il client chiama questa funzione solo se la chiamata InitializeSecurityContext (Digest) ha restituito SEC_I_COMPLETE_NEEDED o SEC_I_COMPLETE_AND_CONTINUE.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	sspi.h (include Security.h)
Libreria	Secur32.lib
DLL	Secur32.dll

Vedi anche

InitializeSecurityContext (digest)

Funzioni SSPI

SecBufferDesc

Condividi tramite