Funzione CompleteAuthToken (sspi.h)
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 |
|---|---|
|
L'handle passato alla funzione non è valido. |
|
Il token passato alla funzione non è valido. |
|
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. |
|
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. |
|
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 |