使用方法

當用戶端向路由表管理員註冊時,它可以匯出一組方法。 其他用戶端會使用這些方法來取得用戶端特定資訊。 方法可啟用路由表管理員用戶端之間的私人通訊。

用戶端可以取得由另一個用戶端匯出的方法清單。 用戶端會呼叫 RtmGetEntityMethods 函 式,並提供目標用戶端的控制碼。

用戶端所匯出的每個方法都是由其方法識別碼唯一識別。 每個用戶端最多可以匯出 32 個方法。 每個方法都會對應至RTM_ENTITY_EXPORT_METHOD結構之 MethodType成員中的位集。 若要叫用多個方法,用戶端應該針對這些方法執行識別碼的邏輯 OR。 實作通訊協定時,必須指定每個通訊協定之輸入和輸出結構的語法和語意。

注意

Microsoft 會保留對應至 MethodType 成員下半部所設定 (16 位) 中設定的方法識別碼值。

 

若要叫用第二個用戶端的 方法,用戶端會呼叫 RtmInvokeMethod 函式。 路由表管理員會仲裁所有叫用用戶端方法的要求。 路由表管理員會在用戶端之間進行仲裁時執行兩個函式:

  • 防止第二個用戶端叫用取消註冊之用戶端的方法。
  • 封鎖方法時保留「叫用」要求,並允許在解除封鎖方法時繼續要求。

如果用戶端必須防止其他用戶端執行其方法,用戶端可以呼叫 RtmBlockMethods。 路由表管理員不允許呼叫 RtmInvokeMethod ,直到用戶端再次解除封鎖其方法為止。

用戶端通常會在對用戶端之間交換的私人資料進行變更時封鎖方法。 封鎖方法是選擇性動作。 用戶端也可以使用內部鎖定來防止其他用戶端叫用方法。

如需示範如何使用這些函式的範例程式碼,請參閱 取得和呼叫用戶端的匯出方法