CancelMibChangeNotify2 関数は、IP インターフェイスの変更、IP アドレスの変更、IP ルートの変更、安定したユニキャスト IP アドレス テーブルの取得要求に関するドライバー変更通知を登録解除します。
構文
NETIOAPI_API CancelMibChangeNotify2(
_In_ HANDLE NotificationHandle
);
パラメーター
-
NotificationHandle [in]
キャンセルする通知を示す通知登録または取得関数から返されるハンドル。
戻り値
CancelMibChangeNotify2 は、関数が成功した場合にSTATUS_SUCCESSを返します。
関数が失敗した場合、CancelMibChangeNotify2 は次のいずれかのエラー コードを返します。
| リターン コード | 形容 |
|---|---|
| STATUS_INVALID_PARAMETER | 無効なパラメーターが関数に渡されました。 CancelMibChangeNotify2 は、NotificationHandle パラメーターが NULL ポインターであった場合、このエラーを返します。 |
| その他の | FormatMessage 関数を使用して、返されたエラーのメッセージ文字列を取得します。 |
備考
CancelMibChangeNotify2 関数は、ローカル コンピューターでの IP インターフェイスの変更、IP アドレスの変更、または IP ルートの変更について以前に要求されたドライバー変更通知を登録解除します。 これらの要求は、NotifyIpInterfaceChange、NotifyRouteChange2、または NotifyUnicastIpAddressChangeを呼び出すことによって行われます。 CancelMibChangeNotify2 関数は、ローカル コンピューターで安定したユニキャスト IP アドレス テーブルを取得する前の要求も取り消します。 この要求は、NotifyStableUnicastIpAddressTable 関数を呼び出すことによって行われます。
これらの通知関数に返される NotificationHandle パラメーターは、CancelMibChangeNotify2 に渡され、ドライバー変更通知の登録を解除したり、保留中の要求を取り消して安定したユニキャスト IP アドレス テーブルを取得したりします。
必要条件
ターゲット プラットフォーム |
ユニバーサル |
バージョン |
Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。 |
ヘッダ |
Netioapi.h (Netioapi.h を含む) |
図書館 |
Netio.lib |
IRQL |
PASSIVE_LEVEL |