Funzione AllocateAndInitializeSid (securitybaseapi.h)

La funzione AllocateAndInitializeSid alloca e inizializza un identificatore di sicurezza (SID) con fino a otto sottoauthority.

Sintassi

BOOL AllocateAndInitializeSid(
  [in]  PSID_IDENTIFIER_AUTHORITY pIdentifierAuthority,
  [in]  BYTE                      nSubAuthorityCount,
  [in]  DWORD                     nSubAuthority0,
  [in]  DWORD                     nSubAuthority1,
  [in]  DWORD                     nSubAuthority2,
  [in]  DWORD                     nSubAuthority3,
  [in]  DWORD                     nSubAuthority4,
  [in]  DWORD                     nSubAuthority5,
  [in]  DWORD                     nSubAuthority6,
  [in]  DWORD                     nSubAuthority7,
  [out] PSID                      *pSid
);

Parametri

[in] pIdentifierAuthority

Puntatore a una struttura SID_IDENTIFIER_AUTHORITY . Questa struttura fornisce il valore dell'autorità di identificatore di primo livello da impostare nel SID.

[in] nSubAuthorityCount

Specifica il numero di sottoauthority da inserire nel SID. Questo parametro identifica anche il numero di parametri di sottoauthority con valori significativi. Questo parametro deve contenere un valore compreso tra 1 e 8.

Ad esempio, un valore pari a 3 indica che i valori di sottoauthority specificati dai parametri dwSubAuthority0, dwSubAuthority1 e dwSubAuthority2 hanno valori significativi e per ignorare il resto.

[in] nSubAuthority0

Valore di subauthority da inserire nel SID.

[in] nSubAuthority1

Valore di subauthority da inserire nel SID.

[in] nSubAuthority2

Valore di subauthority da inserire nel SID.

[in] nSubAuthority3

Valore di subauthority da inserire nel SID.

[in] nSubAuthority4

Valore di subauthority da inserire nel SID.

[in] nSubAuthority5

Valore di subauthority da inserire nel SID.

[in] nSubAuthority6

Valore di subauthority da inserire nel SID.

[in] nSubAuthority7

Valore di subauthority da inserire nel SID.

[out] pSid

Puntatore a una variabile che riceve il puntatore alla struttura SID allocata e inizializzata.

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

Un SID allocato con la funzione AllocateAndInitializeSid deve essere liberato usando la funzione FreeSid .

Questa funzione crea un SID con un valore RID a 32 bit. Per le applicazioni che richiedono valori RID più lunghi, usare CreateWellKnownSid.

Esempio

Per un esempio che usa questa funzione, vedere Creazione di un descrittore di sicurezza per un nuovo oggetto o acquisizione della proprietà dell'oggetto.

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

Controllo dell’accesso

Funzioni di base Controllo di accesso

FreeSid

GetSidIdentifierAuthority

InizializzaSid

SID_IDENTIFIER_AUTHORITY

SID noti