Funzione ApplyControlToken (sspi.h)

Articolo
08/26/2023

La funzione ApplyControlToken consente di applicare un token di controllo a un contesto di sicurezza. Un token può essere ricevuto quando il contesto di sicurezza viene stabilito da una chiamata alla funzione InitializeSecurityContext (Schannel) o con un servizio di sicurezza per messaggio, ad esempio verify o unseal.

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

Questa funzione non è supportata in modalità kernel.

Questa funzione consente l'applicazione di token aggiuntivi o sostitutivi a un contesto.

Sintassi

KSECDDDECLSPEC SECURITY_STATUS SEC_ENTRY ApplyControlToken(
  [in] PCtxtHandle    phContext,
  [in] PSecBufferDesc pInput
);

Parametri

[in] phContext

Handle per il contesto a cui viene applicato il token.

Per informazioni sul modo in cui il provider di servizi condivisi Schannel notifica all'entità remota dell'arresto, vedere la sezione Osservazioni di DecryptMessage (Schannel). Per altre informazioni sull'uso di questa funzione, vedere Arresto di una connessione Schannel.

[in] pInput

Puntatore a una struttura SecBufferDesc contenente un puntatore a una struttura SecBuffer contenente il token di input da applicare al contesto.

Valore restituito

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

Se la funzione ha esito negativo, restituisce un codice di errore diverso da zero. Il codice di errore seguente è uno dei possibili codici di errore che è possibile restituire.

Codice restituito	Descrizione
SEC_E_UNSUPPORTED_FUNCTION	Questo valore viene restituito dalla modalità kernel Schannel per indicare che questa funzione non è supportata.

Commenti

La funzione ApplyControlToken può modificare il contesto in base a questo token. Tra i token che questa funzione può aggiungere al contesto client sono SCHANNEL_ALERT_TOKEN e SCHANNEL_SESSION_TOKEN.

Questa funzione può essere usata per arrestare il contesto di sicurezza sottostante una connessione Schannel esistente. Per informazioni su come eseguire questa operazione, vedere Arresto di una connessione Schannel.

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