Funzione ApplyControlToken (sspi.h)
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 |
|---|---|
|
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 |