Функция ResUtilGetResourceDependencyByNameEx (resapi.h)

Статья
08/25/2023

Перечисляет зависимости указанного ресурса в указанном кластере и возвращает дескриптор зависимости указанного типа. Тип PRESUTIL_GET_RESOURCE_DEPENDENCY_BY_NAME_EX определяет указатель на эту функцию.

Синтаксис

HRESOURCE ResUtilGetResourceDependencyByNameEx(
  [in] HCLUSTER hCluster,
  [in] HANDLE   hSelf,
  [in] LPCWSTR  lpszResourceType,
  [in] BOOL     bRecurse,
  [in] DWORD    dwDesiredAccess
);

Параметры

[in] hCluster

Дескриптор кластера, к которому принадлежит ресурс.

[in] hSelf

Дескриптор для зависимого ресурса. Этот ресурс зависит от одного или нескольких ресурсов.

[in] lpszResourceType

Строка Юникода, завершающаяся null, которая указывает тип ресурса возвращаемой зависимости.

[in] bRecurse

Определяет область поиска. Если значение РАВНО TRUE, функция проверяет все дерево зависимостей в зависимом ресурсе. При значении FALSE функция проверяет только те ресурсы, от которых напрямую зависит зависимый ресурс.

[in] dwDesiredAccess

Запрошенные привилегии доступа. Это может быть любое сочетание GENERIC_READ (0x80000000), GENERIC_ALL (0x10000000) или MAXIMUM_ALLOWED (0x02000000). Если это значение равно нулю (0), может быть возвращена неопределенная ошибка. Использование GENERIC_ALL аналогично вызову ResUtilGetResourceDependencyByName.

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

Если операция выполнена успешно, функция возвращает дескриптор одному из ресурсов, от которого зависит ресурс, указанный параметром hSelf . Вызывающий объект отвечает за закрытие дескриптора путем вызова CloseClusterResource.

Если операция завершается сбоем, функция возвращает значение NULL. Для получения дополнительных сведений вызовите функцию GetLastError .

Код возврата	Описание
HRESOURCE
NULL	Операция не была успешной. Для получения дополнительных сведений вызовите функцию GetLastError.

Требования

Требование	Значение
Минимальная версия клиента	Ни одна версия не поддерживается
Минимальная версия сервера	Windows Server 2012
Целевая платформа	Windows
Header	resapi.h
Библиотека	ResUtils.lib
DLL	ResUtils.dll

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

Функции служебной программы ресурсов

Поделиться через