Funzione CompleteAuthToken (sspi.h)

  • Articolo

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