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