Compartir a través de

Método IEffectivePermission::GetEffectivePermission (aclui.h)

  • Artículo

El método GetEffectivePermission devuelve el permiso efectivo para un tipo de objeto.

Sintaxis

HRESULT GetEffectivePermission(
  [in]  const GUID           *pguidObjectType,
  [in]  PSID                 pUserSid,
  [in]  LPCWSTR              pszServerName,
  [in]  PSECURITY_DESCRIPTOR pSD,
  [out] POBJECT_TYPE_LIST    *ppObjectTypeList,
  [out] ULONG                *pcObjectTypeListLength,
  [out] PACCESS_MASK         *ppGrantedAccessList,
  [out] ULONG                *pcGrantedAccessListLength
);

Parámetros

[in] pguidObjectType

GUID para el tipo de objeto cuyo permiso se está consultando.

[in] pUserSid

Puntero a una estructura de SID que representa la entidad de seguridad cuyo permiso efectivo se determina.

[in] pszServerName

Puntero a una cadena de caracteres anchos terminada en NULL que representa el nombre del servidor.

[in] pSD

Puntero a una estructura de SECURITY_DESCRIPTOR que representa el descriptor de seguridad del objeto. El descriptor de seguridad se usa para realizar la comprobación de acceso.

[out] ppObjectTypeList

Puntero a un puntero a una estructura OBJECT_TYPE_LIST que representa la matriz de tipos de objeto en el árbol de objetos del objeto. Si un objeto no admite el acceso a propiedades, use la técnica siguiente para especificar el valor de la OBJECT_TYPE_LIST.

#include <windows.h>

OBJECT_TYPE_LIST g_DefaultOTL[] = {
 {0, 0, (LPGUID)&GUID_NULL},
};

[out] pcObjectTypeListLength

Puntero a un ULONG que recibe el recuento de tipos de objeto a los que apunta ppObjectTypeList.

[out] ppGrantedAccessList

Puntero a un puntero a un ACCESS_MASK que recibe la matriz de máscaras de acceso concedidas. El sistema operativo usará LocalFree para liberar la memoria asignada para este parámetro.

[out] pcGrantedAccessListLength

Puntero a una variable ULONG que recibe el recuento de máscaras de acceso concedidas a las que apunta el parámetro ppGrantedAccessList .

Valor devuelto

Si la función se realiza correctamente, el valor devuelto se S_OK.

Si se produce un error en la función, el valor devuelto es un VALOR HRESULT que indica el error. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado aclui.h