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 バッファーのサイズを WCHARの数として指定します。出力時に、結果のデータのサイズを、終端の NULL を含む WCHARの数として指定 します。

[out] pszSubnetMask

SubnetMask プライベートプロパティの値を返す出力バッファー。

[in, out] pcchSubnetMask

入力時に、 pszSubnetMask バッファーのサイズを WCHARの数として指定します。出力時に、結果のデータのサイズを、終端の NULL を含む WCHARの数として指定 します。

[out] pszNetwork

Network プライベートプロパティの値を返す出力バッファー。

[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)	バッファーの 1 つのサイズが小さすぎて、結果のデータを保持できなかった。

注釈

リソース 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