CancelMibChangeNotify2 関数 (netioapi.h)
CancelMibChangeNotify2 関数は、IP インターフェイスの変更、IP アドレスの変更、IP ルートの変更、ポートの変更のTeredo、ユニキャスト IP アドレス テーブルが安定していて取得できる場合に、変更通知を登録解除します。
構文
IPHLPAPI_DLL_LINKAGE NETIOAPI_API CancelMibChangeNotify2(
[in] HANDLE NotificationHandle
);
パラメーター
[in] NotificationHandle
キャンセルする通知を示す通知登録または取得関数から返されるハンドル。
戻り値
関数が成功した場合、戻り値はNO_ERROR。
関数が失敗した場合、戻り値は次のいずれかのエラー コードになります。
| リターン コード | 説明 |
|---|---|
|
無効なパラメーターが関数に渡されました。 NotificationHandle パラメーターが NULL ポインターの場合、このエラーが返されます。 |
|
FormatMessage を使用して、返されたエラーのメッセージ文字列を取得します。 |
注釈
CancelMibChangeNotify2 関数は、Windows Vista 以降で定義されています。
次に、
CancelMibChangeNotify2 関数は、以前に IP インターフェイスの変更、IP アドレスの変更、IP ルートの変更、またはローカル コンピューターでのポート変更のTeredo要求された変更通知の登録を解除します。 これらの要求は、 NotifyIpInterfaceChange、 NotifyUnicastIpAddressChange、 NotifyRouteChange2、または NotifyTeredoPortChange を呼び出すことによって行われます。 次に、
CancelMibChangeNotify2 関数は、ユニキャスト IP アドレス テーブルがローカル コンピューターで安定しており、取得できる場合に通知される以前の要求も取り消します。 この要求は、 NotifyStableUnicastIpAddressTable 関数を呼び出すことによって行われます。
これらの通知関数に返される NotificationHandle パラメーターは CancelMibChangeNotify2 に渡され、通知の登録を解除するか、保留中の要求を取り消して安定したユニキャスト IP アドレス テーブルを取得します。
アプリケーションは、同じ NotificationHandle パラメーターの通知コールバック関数を現在実行しているスレッドのコンテキストから CancelMibChangeNotify2 関数を呼び出すことはできません。 それ以外の場合、そのコールバックを実行するスレッドはデッドロックになります。 そのため、 CancelMibChangeNotify2 関数を通知コールバック ルーチンの一部として直接呼び出すことはできません。 より一般的な状況では、 CancelMibChangeNotify2 関数を実行するスレッドは、通知コールバック操作を実行するスレッドが同様のデッドロックが発生するため待機するリソースを所有できません。 CancelMibChangeNotify2 関数は、通知コールバックを受け取るスレッドが依存関係を持たない別のスレッドから呼び出す必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ | UWP アプリ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリ | UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | netioapi.h (Iphlpapi.h を含む) |
| Library | Iphlpapi.lib |
| [DLL] | Iphlpapi.dll |