Funzione InitializeSid (securitybaseapi.h)

Articolo
03/01/2024

La funzione InitializeSid inizializza un identificatore di sicurezza (SID).

Sintassi

BOOL InitializeSid(
  [out] PSID                      Sid,
  [in]  PSID_IDENTIFIER_AUTHORITY pIdentifierAuthority,
  [in]  BYTE                      nSubAuthorityCount
);

Parametri

[out] Sid

Puntatore a una struttura SID da inizializzare.

[in] pIdentifierAuthority

Puntatore a una struttura SID_IDENTIFIER_AUTHORITY da impostare nella struttura SID .

[in] nSubAuthorityCount

Specifica il numero di sottoauthority da impostare nel SID. I valori della sottoauthorità devono essere impostati separatamente, come descritto nella sezione Osservazioni seguenti.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Anche se la funzione InitializeSid imposta il numero di sottoauthority per il SID, non imposta i valori di sottoauthority. Questa operazione deve essere eseguita separatamente usando funzioni come GetSidSubAuthority.

Un'applicazione può usare la funzione AllocateAndInitializeSid per inizializzare un SID e impostare i relativi valori di sottoauthorità.

Questa funzione usa un valore RID a 32 bit. Per le applicazioni che richiedono un valore RID più grande, usare CreateWellKnownSid.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [app desktop \| App UWP]
Server minimo supportato	Windows Server 2003 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	securitybaseapi.h (include Windows.h)
Libreria	Advapi32.lib
DLL	Advapi32.dll