InitializeUnicastIpAddressEntry 関数 (netioapi.h)

[アーティクル]
03/05/2024

InitializeUnicastIpAddressEntry 関数は、ローカルコンピューター上のユニキャスト IP アドレスエントリの既定値を使用して、MIB_UNICASTIPADDRESS_ROW構造体を初期化します。

構文

IPHLPAPI_DLL_LINKAGE VOID NETIOAPI_API_ InitializeUnicastIpAddressEntry(
  [out] PMIB_UNICASTIPADDRESS_ROW Row
);

パラメーター

[out] Row

エントリ時に、ユニキャスト IP アドレスエントリのMIB_UNICASTIPADDRESS_ROW 構造体エントリへのポインター。戻り値が返されると、このパラメーターが指す MIB_UNICASTIPADDRESS_ROW 構造体は、ユニキャスト IP アドレスの既定値で初期化されます。

戻り値

この関数は値を返しません。

注釈

InitializeUnicastIpAddressEntry 関数は、Windows Vista 以降で定義されています。

InitializeUnicastIpAddressEntry 関数は、後で CreateUnicastIpAddressEntry 関数で使用するために、ユニキャスト IP アドレスの既定値を使用して、MIB_UNICASTIPADDRESS_ROW構造体エントリのメンバーを初期化するために使用する必要があります。

入力時に、 InitializeUnicastIpAddressEntry を初期化する新しい MIB_UNICASTIPADDRESS_ROW 構造体を渡す必要があります。

出力時に、 Row パラメーターによって指されるMIB_UNICASTIPADDRESS_ROW構造体の PrefixOrigin メンバーは IpPrefixOriginUnchanged に初期化され、SuffixOrigin メンバーは IpSuffixOriginUnchanged に初期化され、OnLinkPrefixLength メンバーは無効な値に初期化されます。さらに、 PreferredLifetime メンバーと ValidLifetime メンバーは無限に設定され、 SkipAsSource メンバーは FALSE に設定され、他のフィールドは 0 に初期化されます。

InitializeUnicastIpAddressEntry を呼び出した後、アプリケーションは変更するMIB_UNICASTIPADDRESS_ROW エントリのメンバーを変更し、CreateUnicastIpAddressEntry を呼び出して新しいユニキャスト IP アドレスをローカルコンピューターに追加できます。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	netioapi.h (Iphlpapi.h を含む)
Library	Iphlpapi.lib
[DLL]	Iphlpapi.dll