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

Статья
08/25/2023

Извлекает частные свойства первой зависимости IP-адреса, найденной для указанного ресурса. Тип PRESUTIL_GET_RESOURCE_DEPENDENTIP_ADDRESS_PROPS определяет указатель на эту функцию.

Синтаксис

DWORD ResUtilGetResourceDependentIPAddressProps(
  [in]      HRESOURCE hResource,
  [out]     LPWSTR    pszAddress,
  [in, out] DWORD     *pcchAddress,
  [out]     LPWSTR    pszSubnetMask,
  [in, out] DWORD     *pcchSubnetMask,
  [out]     LPWSTR    pszNetwork,
  [in, out] DWORD     *pcchNetwork
);

Параметры

[in] hResource

Дескриптор к ресурсу для запроса зависимостей.

[out] pszAddress

Выходной буфер для возврата значения частного свойства Address .

[in, out] pcchAddress

При входе указывает размер буфера pszAddress в качестве количества WCHARs. В выходных данных указывает размер результирующих данных в виде количества WCHARs, включая завершающее значение NULL.

[out] pszSubnetMask

Выходной буфер для возврата значения частного свойства SubnetMask .

[in, out] pcchSubnetMask

На входных данных указывает размер буфера pszSubnetMask в качестве количества WCHARs. В выходных данных указывает размер результирующих данных в виде количества WCHARs, включая завершающее значение NULL.

[out] pszNetwork

Выходной буфер для возврата значения частного свойства Network .

[in, out] pcchNetwork

На входных данных указывает размер буфера pszNetwork в виде количества WCHARs. В выходных данных указывает размер результирующих данных в виде количества WCHARs, включая завершающее значение NULL.

Windows Server 2008 R2 и Windows Server 2008: Этот параметр называется pcch до Windows Server 2012.

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

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

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

Возвращаемый код или значение	Описание
ERROR_NO_MORE_ITEMS 259 (0x103)	В списке зависимостей указанного ресурса не обнаружено зависимости IP-адреса.
ERROR_RESOURCE_NOT_PRESENT 4316 (0x10DC)	Зависимость IP-адреса не найдена.
ERROR_MORE_DATA 234 (0xEA)	Размер одного из буферов был слишком мал для хранения результирующие данные.

Не вызывайте ResUtilGetResourceDependentIPAddressProps из любой функции точки входа dll ресурсов. ResUtilGetResourceDependentIPAddressProps можно безопасно вызывать из рабочего потока. Дополнительные сведения см. в разделе Вызовы функций, которые следует избегать в библиотеках DLL ресурсов.

Функция ResUtilGetResourceDependentIPAddressProps возвращает только частные свойства для первого ресурса IPv4, от который напрямую зависит ресурс. Функция не проверяет косвенные зависимости (например, ресурс, зависящий от ресурса имени сети , который, в свою очередь, зависит от ресурса IP-адреса ), ресурсы IPv6-адреса или ресурсы IPv6-адресов туннеля .

Требования

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