RtmBlockMethods 関数 (rtmv2.h)
RtmBlockMethods 関数は、指定した宛先、ルート、または次ホップ、またはすべての宛先、ルート、および次ホップに対するメソッドの実行をブロックまたはブロック解除します。
構文
DWORD RtmBlockMethods(
[in] RTM_ENTITY_HANDLE RtmRegHandle,
[in] HANDLE TargetHandle,
[in] UCHAR TargetType,
[in] DWORD BlockingFlag
);
パラメーター
[in] RtmRegHandle
RtmRegisterEntity の以前の呼び出しから取得したクライアントを処理します。
[in] TargetHandle
メソッドをブロックする宛先、ルート、または次ホップを処理します。 このパラメーターは省略可能であり、 NULL に設定すると、すべてのターゲットのメソッドをブロックできます。
[in] TargetType
TargetHandle のハンドルの種類を指定します。 このパラメーターは省略可能であり、 NULL に設定すると、すべてのターゲットのメソッドをブロックできます。 次のフラグが使用されます。
Type | 説明 |
---|---|
|
TargetHandle は宛先です。 |
|
TargetHandle は次ホップです。 |
|
TargetHandle はルートです。 |
[in] BlockingFlag
メソッドをブロックするかブロック解除するかを指定します。 次のフラグが使用されます。
定数 | 説明 |
---|---|
|
指定したターゲットのブロック メソッド。 |
|
指定したターゲットのメソッドのブロックを解除します。 |
戻り値
関数が成功した場合、戻り値はNO_ERROR。
関数が失敗した場合、戻り値は次のエラー コードになります。
値 | 意味 |
---|---|
|
ハンドルが正しくありません。 |
注釈
現在、この関数では、特定の宛先、ルート、または次ホップのブロックメソッドはサポートされていません。
通常、メソッドは、ルート内のクライアント固有のデータが変更されている場合にブロックされます。クライアントはメソッドをブロックし、データを再配置してから、メソッドのブロックを解除します。
クライアントは、短期間だけメソッドをブロックする必要があります。 2 番目のクライアントが RtmInvokeMethod を呼び出し、最初のクライアントのメソッドがブロックされている場合、 RtmInvokeMethod はメソッドのブロックが解除され、関数呼び出しが完了するまで戻りません。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | サポートなし |
サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | rtmv2.h |
Library | Rtm.lib |
[DLL] | Rtm.dll |