Método IAccessControl::GetAllAccessRights (iaccess.h)

Artículo
02/26/2024

Obtiene toda la lista de derechos de acceso o el propietario y el grupo del objeto especificado.

Sintaxis

HRESULT GetAllAccessRights(
  [in]  LPWSTR                            lpProperty,
  [out] PACTRL_ACCESSW_ALLOCATE_ALL_NODES *ppAccessList,
  [out] PTRUSTEEW                         *ppOwner,
  [out] PTRUSTEEW                         *ppGroup
);

Parámetros

[in] lpProperty

El nombre de la propiedad. Si usa la implementación COM de IAccessControl, este parámetro debe ser NULL.

[out] ppAccessList

Dirección de la variable de puntero que recibe un puntero a la estructura de la lista de acceso. Este parámetro no puede ser ACTRL_ACCESS.

Si la llamada se realiza correctamente, el autor de la llamada debe liberar la memoria asignada con la función CoTaskMemFree . Tenga en cuenta que la memoria es allocate(all_nodes), lo que significa que todas las subestructuras se asignan en un bloque. Por lo tanto, toda la estructura de datos debe liberarse mediante una sola llamada a CoTaskMemFree.

[out] ppOwner

Puntero a una estructura DE ADMINISTRADOR que recibe la información del propietario. Si este parámetro no es NULL y la función se realiza correctamente, el autor de la llamada debe liberar la memoria con CoTaskMemFree.

[out] ppGroup

Puntero a una estructura DE ADMINISTRADOR que recibe la información del grupo. Si este parámetro no es NULL y la función se realiza correctamente, el autor de la llamada debe liberar la memoria con CoTaskMemFree.

Valor devuelto

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	iaccess.h

Consulte también

ACTRL_ACCESS

IAccessControl