Funzione RtlInitializeSid (ntifs.h)

Articolo
02/26/2024

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

Condividi tramite