ResUtilGetResourceDependentIPAddressProps 函式 (resapi.h)

發行項
03/01/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 緩衝區的大小指定為 WCHARs 的計數。在輸出上，將產生的數據大小指定為包含終止 NULL 的 WCHAR 計數。

[out] pszNetwork

傳回 Network private 屬性值的輸出緩衝區。

[in, out] pcchNetwork

在輸入上，將 pszNetwork 緩衝區的大小指定為 WCHAR 的計數。在輸出上，將產生的數據大小指定為包含終止 NULL 的 WCHAR 計數。

Windows Server 2008 R2 和 Windows Server 2008： 此參數在 Windows Server 2012 之前命名為pcch。

傳回值

如果作業成功，函式會傳回 ERROR_SUCCESS ( 0) 。

如果作業失敗，函式會傳回系統錯誤碼。以下是可能的錯誤碼。

傳回碼/值	Description
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
程式庫	ResUtils.lib
Dll	ResUtils.dll