rtmGetEntityMethods 函式 (rtmv2.h)

  • 發行項

RtmGetEntityMethods 函式會查詢指定的用戶端，以判斷哪些方法可供另一個用戶端叫用。

語法

DWORD RtmGetEntityMethods(
  [in]      RTM_ENTITY_HANDLE         RtmRegHandle,
  [in]      RTM_ENTITY_HANDLE         EntityHandle,
  [in, out] PUINT                     NumMethods,
  [out]     PRTM_ENTITY_EXPORT_METHOD ExptMethods
);

參數

[in] RtmRegHandle

從 先前呼叫 RtmRegisterEntity 取得的用戶端句柄。

[in] EntityHandle

要為其取得方法的用戶端句柄。

[in, out] NumMethods

在輸入時， NumMethods 會指定 UINT 值的有效指標。 指定零，以傳回可供導出的方法數目。

輸出時， NumMethods 會接收用戶端匯出的方法數目。

[out] ExptMethods

接收 RTM_ENTITY_EXPORT_METHOD 結構的指標，其中包含呼叫用戶端所要求的方法標識碼集。

傳回值

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

如果函式失敗，傳回值就是下列其中一個錯誤碼。

值 意義
ERROR_INSUFFICIENT_BUFFER
 提供的緩衝區不夠大，無法保存所有要求的資訊。

備註

請勿直接呼叫另一個用戶端的 方法，請一律使用 RtmInvokeMethod。 路由表管理員會在使用 RtmInvokeMethod 時執行錯誤檢查，以確保用戶端未取消註冊或尚未註冊。

如果傳回 ERROR_INSUFFICIENT_BUFFER，ExptMethods 中可能會有一些數據; NumMethods 會指定緩衝區中實際容納的方法數目。

不再需要實體句柄時，請呼叫 RtmReleaseEntities 來釋放它。

如需使用此函式的範例程式代碼，請參閱 取得和呼叫客戶端的匯出方法。

規格需求

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

另請參閱

RtmBlockMethods

RtmInvokeMethod