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 |