Метод IEffectivePermission::GetEffectivePermission (aclui.h)

Метод GetEffectivePermission возвращает действующее разрешение для типа объекта.

Синтаксис

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
);

Параметры

[in] pguidObjectType

GUID для типа объекта, разрешение которого запрашивается.

[in] pUserSid

Указатель на структуру SID , представляющую субъект безопасности, для которого определяется действующее разрешение.

[in] pszServerName

Указатель на строку расширенных символов, завершающуюся null, которая представляет имя сервера.

[in] pSD

Указатель на структуру SECURITY_DESCRIPTOR , представляющую дескриптор безопасности объекта. Дескриптор безопасности используется для выполнения проверка доступа.

[out] ppObjectTypeList

Указатель на указатель на структуру OBJECT_TYPE_LIST , представляющую массив типов объектов в дереве объектов для объекта. Если объект не поддерживает доступ к свойствам, используйте следующий метод, чтобы указать значение для OBJECT_TYPE_LIST.

#include <windows.h>

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

[out] pcObjectTypeListLength

Указатель на ULONG , получающий количество типов объектов, на которые указывает ppObjectTypeList.

[out] ppGrantedAccessList

Указатель на указатель на ACCESS_MASK , получающий массив предоставленных масок доступа. Операционная система будет использовать LocalFree для освобождения памяти, выделенной для этого параметра.

[out] pcGrantedAccessListLength

Указатель на переменную ULONG , которая получает количество предоставленных масок доступа, на которые указывает параметр ppGrantedAccessList .

Возвращаемое значение

Если функция выполнена успешно, возвращаемое значение будет S_OK.

Если функция завершается сбоем, возвращаемым значением является HRESULT , указывающее на ошибку. Список распространенных кодов ошибок см. в разделе Общие значения HRESULT.

Требования