ResUtilGetResourceDependentIPAddressProps 函数 (resapi.h)

项目
03/04/2024

检索为指定资源找到的第一个 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 private 属性的值的输出缓冲区。

[in, out] pcchAddress

输入时，将 pszAddress 缓冲区的大小指定为 WCHAR的计数。在输出中，将生成的数据的大小指定为包含终止 NULL 的 WCHAR计数。

[out] pszSubnetMask

用于返回 SubnetMask 专用属性的值的输出缓冲区。

[in, out] pcchSubnetMask

输入时，将 pszSubnetMask 缓冲区的大小指定为 WCHAR的计数。在输出中，将生成的数据的大小指定为包含终止 NULL 的 WCHAR计数。

[out] pszNetwork

用于返回网络专用属性值的输出缓冲区。

[in, out] pcchNetwork

输入时，将 pszNetwork 缓冲区的大小指定为 WCHAR计数。在输出中，将生成的数据的大小指定为包含终止 NULL 的 WCHAR计数。

Windows Server 2008 R2 和 Windows Server 2008： 此参数在Windows Server 2012之前命名为 pcch。

返回值

如果操作成功，函数将返回 ERROR_SUCCESS (0) 。

如果操作失败，该函数将返回系统错误代码。下面是可能的错误代码。

返回代码/值	说明
ERROR_NO_MORE_ITEMS 259 (0x103)	在指定资源的依赖项列表中找不到任何 IP 地址依赖项。
ERROR_RESOURCE_NOT_PRESENT 4316 (0x10DC)	未找到 IP 地址依赖项。
ERROR_MORE_DATA 234 (0xEA)	其中一个缓冲区的大小太小，无法容纳生成的数据。

注解

不要从任何资源 DLL 入口点函数调用 ResUtilGetResourceDependentIPAddressProps 。可以从工作线程安全地调用 ResUtilGetResourceDependentIPAddressProps。有关详细信息，请参阅在资源 DLL 中对避免的函数调用。

ResUtilGetResourceDependentIPAddressProps 函数仅返回该资源直接依赖的第一个 IPv4 资源的专用属性。函数不会检查间接依赖项 (例如依赖于网络名称资源的资源，而网络名称资源又依赖于 IP 地址资源) 、 IPv6 地址资源或 IPv6 隧道地址资源。

要求

要求	值
最低受支持的客户端	无受支持的版本
最低受支持的服务器	Windows Server 2008 Enterprise、Windows Server 2008 Datacenter
目标平台	Windows
标头	resapi.h
Library	ResUtils.lib
DLL	ResUtils.dll