InitializeUnicastIpAddressEntry 関数
InitializeUnicastIpAddressEntry 関数は、ローカル コンピューター上のユニキャスト IP アドレス エントリの既定値を使用して、MIB_UNICASTIPADDRESS_ROW 構造体を初期化します。
構文
VOID NETIOAPI_API_ InitializeUnicastIpAddressEntry(
_Out_ PMIB_UNICASTIPADDRESS_ROW Row
);
パラメーター
- Row [out]
エントリにおける、ユニキャスト IP アドレス エントリの MIB_UNICASTIPADDRESS_ROW 構造体エントリへのポインター。 戻り値として、このパラメーターが指す MIB_UNICASTIPADDRESS_ROW 構造体は、ユニキャスト IP アドレスの既定値で初期化されます。
戻り値
なし
解説
ドライバーは、InitializeUnicastIpAddressEntry 関数を使用して、後に CreateUnicastIpAddressEntry 関数で使用するために、ユニキャスト IP アドレスの既定値を使用して MIB_UNICASTIPADDRESS_ROW 構造体エントリのメンバーを初期化する必要があります。
入力時に、ドライバーは InitializeUnicastIpAddressEntry を初期化する新しい MIB_UNICASTIPADDRESS_ROW 構造体を渡す必要があります。
出力時に、Row パラメーターが指す MIB_UNICASTIPADDRESS_ROW 構造体 のメンバーは、次のように初期化されます。
PrefixOrigin
NL_PREFIX_ORIGIN リストの IpPrefixOriginUnchanged 値に設定します。SuffixOrigin
NL_PREFIX_ORIGIN リストの IpSuffixOriginUnchanged 値に設定します。OnLinkPrefixLength
無効な値に設定します。PreferredLifetime と ValidLifetime
無限の値に設定します。SkipAsSource
FALSE に設定します。その他の全メンバー
0 に設定します。
ドライバーが InitializeUnicastIpAddressEntry を呼び出した後、ドライバーは修正する MIB_UNICASTIPADDRESS_ROW エントリのメンバーを変更し、CreateUnicastIpAddressEntry を呼び出して、新しいユニキャスト IP アドレスをローカル コンピューターに追加できます。
要件
対象プラットフォーム |
ユニバーサル |
バージョン |
Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。 |
ヘッダー |
Netioapi.h (Netioapi.h を含む) |
ライブラリ |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |