Funzione SeCreateClientSecurity (ntifs.h)
La routine SeCreateClientSecurity inizializza una struttura del contesto client di sicurezza con le informazioni necessarie per chiamare SeImpersonateClientEx.
Sintassi
NTSTATUS SeCreateClientSecurity(
[in] PETHREAD ClientThread,
[in] PSECURITY_QUALITY_OF_SERVICE ClientSecurityQos,
BOOLEAN RemoteSession,
[out] PSECURITY_CLIENT_CONTEXT ClientContext
);
Parametri
[in] ClientThread
Puntatore al thread del client da rappresentare.
[in] ClientSecurityQos
Puntatore a una struttura SECURITY_QUALITY_OF_SERVICE allocata dal chiamante che indica quale forma di rappresentazione deve essere eseguita.
RemoteSession
Impostare su TRUE se il server della richiesta del client è remoto.
[out] ClientContext
Puntatore a una struttura SECURITY_CLIENT_CONTEXT allocata dal chiamante da inizializzare.
Valore restituito
| Codice restituito | Descrizione |
|---|---|
| STATUS_SUCCESS | Il contesto client di sicurezza è stato inizializzato correttamente. |
| STATUS_BAD_IMPERSONATION_LEVEL | Il client da rappresentare rappresenta attualmente un client di propria proprietà e uno dei seguenti è true: (1) Il token effettivo del client non può essere passato per l'uso da parte di un altro server, perché il livello di rappresentazione è SecurityAnonymous o SecurityIdentification. (2) ServerIsRemote è TRUE e il thread client rappresenta il client a livello diverso da SecurityDelegation . |
Commenti
SeCreateClientSecurity inizializza un blocco di contesto di sicurezza client per rappresentare il contesto di sicurezza di un client.
Se il membro ContextTrackingMode di ClientSecurityQos è impostato su SECURITY_DYNAMIC_TRACKING e ServerIsRemote è impostato su FALSE, SeCreateClientSecurity usa un riferimento al token effettivo del client. In caso contrario, SeCreateClientSecurity crea una copia del token del client.
Ogni chiamata a SeCreateClientSecurity deve essere confrontata con una chiamata successiva a SeDeleteClientSecurity.
Per altre informazioni sulla sicurezza e sul controllo di accesso, vedere Modello di sicurezza di Windows per sviluppatori di driver e la documentazione su questi argomenti in Windows SDK.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| Intestazione | ntifs.h (include Ntifs.h) |
| Libreria | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |