CancelMibChangeNotify2 関数

CancelMibChangeNotify2 関数は、IP インターフェイスの変更、IP アドレスの変更、IP ルートの変更、安定したユニキャスト IP アドレス テーブルの取得要求に関するドライバー変更通知を登録解除します。

構文

NETIOAPI_API CancelMibChangeNotify2(
  _In_ HANDLE NotificationHandle
);

パラメーター

  • NotificationHandle [in]
    キャンセルする通知を示す通知登録または取得関数から返されるハンドル。

戻り値

関数が成功した場合、CancelMibChangeNotify2 は、STATUS_SUCCESS を返します。

関数が失敗した場合、CancelMibChangeNotify2 は以下のいずれかのエラーコードを返します。

リターン コード 説明
STATUS_INVALID_PARAMETER

その関数に無効なパラメーターが渡された。 NotificationHandle パラメーターが NULL ポインターであった場合、CancelMibChangeNotify2 はこのエラーを返します。

その他

FormatMessage 関数を使用して、返されたエラーのメッセージ文字列を取得します。

解説

CancelMibChangeNotify2 関数は、以前に IP インターフェイスの変更、IP アドレスの変更、またはローカル コンピューターでの IP ルートの変更に対して要求されたドライバー変更通知を登録解除します。 これらの要求は、NotifyIpInterfaceChangeNotifyRouteChange2、または NotifyUnicastIpAddressChange を呼び出すことによって行われます。 CancelMibChangeNotify2 関数は、ローカル コンピューター上の安定したユニキャスト IP アドレス テーブルを取得する前の要求も取り消します。 この要求は、NotifyStableUnicastIpAddressTable 関数を呼び出すことによって行われます。

これらの通知関数に返される NotificationHandle パラメーターは CancelMibChangeNotify2 に渡され、ドライバー変更通知の登録を解除したり、保留中の要求を取り消して安定したユニキャスト IP アドレス テーブルを取得したりできます。

要件

対象プラットフォーム

ユニバーサル

バージョン

Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。

ヘッダー

Netioapi.h (Netioapi.h を含む)

ライブラリ

Netio.lib

IRQL

PASSIVE_LEVEL

関連項目

NotifyIpInterfaceChange

NotifyRouteChange2

NotifyStableUnicastIpAddressTable

NotifyUnicastIpAddressChange