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 來封鎖所有目標的方法。 使用下列旗標。
類型 | 意義 |
---|---|
|
TargetHandle 是目的地。 |
|
TargetHandle 是下一個躍點。 |
|
TargetHandle 是路由。 |
[in] BlockingFlag
指定是否要封鎖或解除封鎖方法。 使用下列旗標。
常數 | 意義 |
---|---|
|
封鎖指定目標的方法。 |
|
解除封鎖指定目標的方法。 |
傳回值
如果函式成功,傳回值會NO_ERROR。
如果函式失敗,傳回值會是下列錯誤碼。
值 | 意義 |
---|---|
|
控制代碼無效。 |
備註
目前,此函式不支援特定目的地、路由或下一個躍點的封鎖方法。
變更路由中的用戶端特定數據時,通常會封鎖方法;用戶端會封鎖方法、重新排列數據,然後解除封鎖方法。
客戶端應該只在短時間內封鎖方法。 如果第二個用戶端呼叫 RtmInvokeMethod 並封鎖第一個用戶端的方法, 則 RtmInvokeMethod 不會傳回,直到方法解除封鎖且函式呼叫完成為止。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 都不支援 |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | rtmv2.h |
程式庫 | Rtm.lib |
Dll | Rtm.dll |