Función GetSecurityDescriptorOwner (securitybaseapi.h)

La función GetSecurityDescriptorOwner recupera la información del propietario de un descriptor de seguridad.

Sintaxis

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

Parámetros

[in] pSecurityDescriptor

Puntero a una estructura de SECURITY_DESCRIPTOR cuya información de propietario recupera la función.

[out] pOwner

Puntero a un puntero a un identificador de seguridad (SID) que identifica al propietario cuando la función devuelve. Si el descriptor de seguridad no contiene un propietario, la función establece el puntero al que apunta pOwner en NULL y omite el parámetro de salida restante, lpbOwnerDefaulted. Si el descriptor de seguridad contiene un propietario, la función establece el puntero al que apunta pOwner a la dirección del SID propietario del descriptor de seguridad y proporciona un valor válido para la variable a la que apunta lpbOwnerDefaulted.

[out] lpbOwnerDefaulted

Puntero a una marca que se establece en el valor de la marca SE_OWNER_DEFAULTED en la estructura SECURITY_DESCRIPTOR_CONTROL cuando la función devuelve. Si el valor almacenado en la variable a la que apunta el parámetro pOwner es NULL, no se establece ningún valor.

Valor devuelto

Si la función se ejecuta correctamente, la función devuelve un valor distinto de cero.

Si se produce un error en la función, devuelve cero. Para obtener información de error extendida, llame a GetLastError.

Requisitos

   
Cliente mínimo compatible Windows XP [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2003 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado securitybaseapi.h (incluya Windows.h)
Library Advapi32.lib
Archivo DLL Advapi32.dll

Consulte también

GetSecurityDescriptorControl

GetSecurityDescriptorDacl

GetSecurityDescriptorGroup

GetSecurityDescriptorLength

GetSecurityDescriptorSacl

IsValidSecurityDescriptor

Access Control de bajo nivel

Funciones de Access Control de bajo nivel

SECURITY_DESCRIPTOR

SECURITY_DESCRIPTOR_CONTROL

SetSecurityDescriptorOwner