Funzione GetSidSubAuthority (securitybaseapi.h)

Articolo
03/01/2024

La funzione GetSidSubAuthority restituisce un puntatore a una sottoauthorità specificata in un identificatore di sicurezza (SID). Il valore di subauthority è un identificatore relativo (RID).

Sintassi

PDWORD GetSidSubAuthority(
  [in] PSID  pSid,
  [in] DWORD nSubAuthority
);

Parametri

[in] pSid

Puntatore alla struttura SID da cui deve essere restituito un puntatore a una sottoauthorità.

Questa funzione non gestisce le strutture SID non valide. Chiamare la funzione IsValidSid per verificare che la struttura SID sia valida prima di chiamare questa funzione.

[in] nSubAuthority

Specifica un valore di indice che identifica l'elemento matrice di sottoauthority il cui indirizzo verrà restituito dalla funzione. La funzione non esegue test di convalida su questo valore. Un'applicazione può chiamare la funzione GetSidSubAuthorityCount per individuare l'intervallo di valori accettabili.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un puntatore alla sottoauthorità SID specificata. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Se la funzione ha esito negativo, il valore restituito non è definito. La funzione ha esito negativo se la struttura SID specificata non è valida o se il valore di indice specificato dal parametro nSubAuthority non è valido.

Commenti

La struttura SID specificata in pSid usa un valore RID a 32 bit. Per le applicazioni che richiedono valori RID più lunghi, usare CreateWellKnownSid e funzioni correlate.

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