Win32 API 日本語リファレンス
ホーム › Networking.Clustering › PRESUTIL_GET_RESOURCE_DEPENDENTIP_ADDRESS_PROPS

PRESUTIL_GET_RESOURCE_DEPENDENTIP_ADDRESS_PROPS

コールバック

シグネチャ

DWORD PRESUTIL_GET_RESOURCE_DEPENDENTIP_ADDRESS_PROPS(
    HRESOURCE hResource,
    LPWSTR pszAddress,
    DWORD* pcchAddress,
    LPWSTR pszSubnetMask,
    DWORD* pcchSubnetMask,
    LPWSTR pszNetwork,
    DWORD* pcchNetwork
);

パラメーター

フィールド型説明
hResourceHRESOURCE依存関係を照会するリソースのハンドルです。
pszAddressLPWSTRAddress プライベートプロパティの値を返すための出力バッファーです。
pcchAddressDWORD*入力時は、pszAddress バッファーのサイズを WCHAR 単位の個数で指定します。出力時は、終端の NULL を含む結果データのサイズを WCHAR 単位の個数で返します。
pszSubnetMaskLPWSTRSubnetMask プライベートプロパティの値を返すための出力バッファーです。
pcchSubnetMaskDWORD*入力時は、pszSubnetMask バッファーのサイズを WCHAR 単位の個数で指定します。出力時は、終端の NULL を含む結果データのサイズを WCHAR 単位の個数で返します。
pszNetworkLPWSTRNetwork プライベートプロパティの値を返すための出力バッファーです。
pcchNetworkDWORD*

入力時は、pszNetwork バッファーのサイズを WCHAR 単位の個数で指定します。出力時は、終端の NULL を含む結果データのサイズを WCHAR 単位の個数で返します。

Windows Server 2008 R2 および Windows Server 2008: Windows Server 2012 より前では、このパラメーターの名前は pcch です。

公式ドキュメント

指定した リソース について最初に見つかった IP Address 依存関係 の プライベートプロパティ を取得します。PRESUTIL_GET_RESOURCE_DEPENDENTIP_ADDRESS_PROPS 型は、この関数へのポインターを定義します。

戻り値

操作が成功した場合、この関数は ERROR_SUCCESS (0) を返します。

操作が失敗した場合、この関数は システムエラーコード を返します。返される可能性があるエラーコードは次のとおりです。

戻り値/値 説明
ERROR_NO_MORE_ITEMS
259 (0x103)
 指定したリソースの依存関係リストに IP Address 依存関係が見つかりませんでした。
ERROR_RESOURCE_NOT_PRESENT
4316 (0x10DC)
 IP Address 依存関係が見つかりませんでした。
ERROR_MORE_DATA
234 (0xEA)
 いずれかのバッファーのサイズが小さすぎて、結果のデータを格納できませんでした。

解説(Remarks)

ResUtilGetResourceDependentIPAddressProps は、リソース DLL のどのエントリポイント関数からも呼び出さないでください。ResUtilGetResourceDependentIPAddressProps は、ワーカースレッドからであれば安全に呼び出せます。詳細については、Function Calls to Avoid in Resource DLLs を参照してください。

ResUtilGetResourceDependentIPAddressProps 関数は、リソースが直接依存している最初の IPv4 リソースのプライベートプロパティのみを返します。間接的な依存関係 (たとえば、IP Address リソースに依存する ネットワーク名 リソースに、さらに依存しているような場合)、IPv6 Address リソース、IPv6 Tunnel Address リソースは検査しません。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)