Функция GetInheritanceSourceW (aclapi.h)

Функция GetInheritanceSource возвращает сведения об источнике унаследованных записей управления доступом (ACE) в списке управления доступом (ACL).

Синтаксис

DWORD GetInheritanceSourceW(
  [in]           LPWSTR                pObjectName,
  [in]           SE_OBJECT_TYPE        ObjectType,
  [in]           SECURITY_INFORMATION  SecurityInfo,
  [in]           BOOL                  Container,
  [in, optional] GUID                  **pObjectClassGuids,
  [in]           DWORD                 GuidCount,
  [in]           PACL                  pAcl,
  [in, optional] PFN_OBJECT_MGR_FUNCTS pfnArray,
  [in]           PGENERIC_MAPPING      pGenericMapping,
  [out]          PINHERITED_FROMW      pInheritArray
);

Параметры

[in] pObjectName

Указатель на имя объекта, который использует список ACL для проверки.

[in] ObjectType

Тип объекта, указанный pObjectName. Возможные значения: SE_FILE_OBJECT, SE_REGISTRY_KEY, SE_DS_OBJECT и SE_DS_OBJECT_ALL.

[in] SecurityInfo

Тип ACL, используемый с объектом . Возможные значения: DACL_SECURITY_INFORMATION или SACL_SECURITY_INFORMATION.

[in] Container

Значение TRUE , если объект является объектом контейнера, или false , если объект является конечным объектом. Обратите внимание, что единственным конечным объектом является SE_FILE_OBJECT.

[in, optional] pObjectClassGuids

Необязательный список идентификаторов GUID, определяющих типы объектов или имена, связанные с pObjectName. Это значение может иметь значение NULL , если диспетчер объектов поддерживает только один класс объектов или не имеет guid, связанного с классом объекта.

[in] GuidCount

Число идентификаторов GUID, на которые указывает pObjectClassGuids.

[in] pAcl

Список ACL для объекта .

[in, optional] pfnArray

Зарезервировано. Задайте для этого параметра значение NULL.

[in] pGenericMapping

Сопоставление универсальных прав с конкретными правами для объекта.

[out] pInheritArray

Указатель на массив INHERITED_FROM структур, которые функция GetInheritanceSource заполняет данными наследования. Вызывающий объект должен выделить достаточно памяти для записи для каждого ACE в ACL.

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

Если функция завершается успешно, функция возвращает ERROR_SUCCESS.

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

Комментарии

Функция GetInheritanceSource выделяет память для имен, возвращаемых в структуре INHERITED_FROM . Когда функция завершит использование этой памяти, вызывающая программа должна освободить ее, вызвав Метод FreeInheritedFromArray. Обратите внимание, что вызывающий объект должен предоставлять память для самого массива. Если вызывающий объект выделил память, вызывающий объект должен освободить ее после вызова FreeInheritedFromArray.

Эта функция не обрабатывает состояния гонки. Если поток вызывает эту функцию в приблизительное время, когда другой поток изменяет дескриптор безопасности объекта, эта функция может завершиться ошибкой.

Требования

См. также раздел

FreeInheritedFromArray