Condividi tramite


Funzione GetSidSubAuthority (securitybaseapi.h)

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

Vedi anche

Panoramica Controllo di accesso

Funzioni di base Controllo di accesso

CreateWellKnownSid

GetLengthSid

GetSidIdentifierAuthority

GetSidLengthRequired

GetSidSubAuthorityCount

IsValidSid

SID