Funzione InitializeSid (securitybaseapi.h)

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

Vedi anche

Panoramica Controllo di accesso

AllocateAndInitializeSid

Funzioni di base Controllo di accesso

CreateWellKnownSid

GetLengthSid

GetSidIdentifierAuthority

GetSidLengthRequired

GetSidSubAuthority

GetSidSubAuthorityCount

IsValidSid

SID

SID_IDENTIFIER_AUTHORITY