Funzione RtlInitializeSid (ntifs.h)

  • Articolo

La routine RtlInitializeSid inizializza una struttura SID (Security Identifier).

Sintassi

NTSYSAPI NTSTATUS RtlInitializeSid(
  [out] PSID                      Sid,
  [in]  PSID_IDENTIFIER_AUTHORITY IdentifierAuthority,
  [in]  UCHAR                     SubAuthorityCount
);

Parametri

[out] Sid

Puntatore a una struttura SID allocata dal chiamante da inizializzare.

[in] IdentifierAuthority

Puntatore a una struttura SID_IDENTIFIER_AUTHORITY da impostare nella struttura SID.

[in] SubAuthorityCount

Numero di sottoauthorità da impostare nel SID. I valori di subauthority devono essere impostati separatamente, come descritto nella sezione Osservazioni seguenti.

Valore restituito

RtlInitializeSid restituisce uno dei seguenti elementi:

Codice restituito Descrizione
STATUS_SUCCESS
 Il SID è stato inizializzato correttamente.
STATUS_INVALID_PARAMETER
 Il valore SubAuthorityCount specificato non è valido.

Commenti

Anche se RtlInitializeSid imposta il numero di sottoauthority per il SID, non imposta i valori di sottoauthority. Questa operazione deve essere eseguita separatamente chiamando RtlSubAuthoritySid.

Per altre informazioni sul controllo di sicurezza e accesso, vedere Modello di sicurezza di Windows per sviluppatori driver e la documentazione su questi argomenti in Windows SDK.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000
Piattaforma di destinazione Universale
Intestazione ntifs.h (include Ntifs.h)
Libreria NtosKrnl.lib
DLL NtosKrnl.exe (modalità kernel); Ntdll.dll (modalità utente)
IRQL < DISPATCH_LEVEL

Vedi anche

RtlSubAuthoritySid

SID

SID_IDENTIFIER_AUTHORITY