Funzione GetSecurityDescriptorOwner (securitybaseapi.h)

Articolo
03/01/2024

La funzione GetSecurityDescriptorOwner recupera le informazioni sul proprietario da un descrittore di sicurezza.

Sintassi

BOOL GetSecurityDescriptorOwner(
  [in]  PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [out] PSID                 *pOwner,
  [out] LPBOOL               lpbOwnerDefaulted
);

Parametri

[in] pSecurityDescriptor

Puntatore a una struttura SECURITY_DESCRIPTOR la cui proprietà recupera le informazioni sulla funzione.

[out] pOwner

Puntatore a un puntatore a un IDENTIFICATORe di sicurezza (SID) che identifica il proprietario quando la funzione restituisce. Se il descrittore di sicurezza non contiene un proprietario, la funzione imposta il puntatore a cui fa riferimento pOwner su NULL e ignora il parametro di output rimanente, lpbOwnerDefaulted. Se il descrittore di sicurezza contiene un proprietario, la funzione imposta il puntatore a cui fa riferimento pOwner sull'indirizzo del SID proprietario del descrittore di sicurezza e fornisce un valore valido per la variabile a cui punta lpbOwnerDefaulted.

[out] lpbOwnerDefaulted

Puntatore a un flag impostato sul valore del flag SE_OWNER_DEFAULTED nella struttura SECURITY_DESCRIPTOR_CONTROL quando la funzione restituisce. Se il valore archiviato nella variabile a cui punta il parametro pOwner è NULL, non viene impostato alcun valore.

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce un valore diverso da zero.

Se la funzione ha esito negativo, restituisce zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

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