InitializeUnicastIpAddressEntry 関数 (netioapi.h)

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

こちらもご覧ください

CreateUnicastIpAddressEntry

DeleteUnicastIpAddressEntry

GetUnicastIpAddressEntry

GetUnicastIpAddressTable

IP ヘルパー関数リファレンス

MIB_UNICASTIPADDRESS_ROW

MIB_UNICASTIPADDRESS_TABLE

NotifyUnicastIpAddressChange

SetUnicastIpAddressEntry