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 來封鎖所有目標的方法。 使用下列旗標。

類型 意義
DEST_TYPE
 TargetHandle 是目的地。
NEXTHOP_TYPE
 TargetHandle 是下一個躍點。
ROUTE_TYPE
 TargetHandle 是路由。

[in] BlockingFlag

指定是否要封鎖或解除封鎖方法。 使用下列旗標。

常數 意義
RTM_BLOCK_METHODS
 封鎖指定目標的方法。
RTM_RESUME_METHODS
 解除封鎖指定目標的方法。

傳回值

如果函式成功，傳回值會NO_ERROR。

如果函式失敗，傳回值會是下列錯誤碼。

值 意義
ERROR_INVALID_HANDLE
 控制代碼無效。
 
 

備註

目前，此函式不支援特定目的地、路由或下一個躍點的封鎖方法。

變更路由中的用戶端特定數據時，通常會封鎖方法;用戶端會封鎖方法、重新排列數據，然後解除封鎖方法。

客戶端應該只在短時間內封鎖方法。 如果第二個用戶端呼叫 RtmInvokeMethod 並封鎖第一個用戶端的方法， 則 RtmInvokeMethod 不會傳回，直到方法解除封鎖且函式呼叫完成為止。

規格需求

需求 值
最低支援的用戶端 都不支援
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 rtmv2.h
程式庫 Rtm.lib
Dll Rtm.dll

另請參閱

RtmGetEntityMethods

RtmInvokeMethod