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。
如果函式失敗,傳回值就是下列其中一個錯誤碼。
值 | 意義 |
---|---|
|
提供的緩衝區不夠大,無法保存所有要求的資訊。 |
備註
請勿直接呼叫另一個用戶端的 方法,請一律使用 RtmInvokeMethod。 路由表管理員會在使用 RtmInvokeMethod 時執行錯誤檢查,以確保用戶端未取消註冊或尚未註冊。
如果傳回 ERROR_INSUFFICIENT_BUFFER,ExptMethods 中可能會有一些數據; NumMethods 會指定緩衝區中實際容納的方法數目。
不再需要實體句柄時,請呼叫 RtmReleaseEntities 來釋放它。
如需使用此函式的範例程式代碼,請參閱 取得和呼叫客戶端的匯出方法。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 都不支援 |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | rtmv2.h |
程式庫 | Rtm.lib |
Dll | Rtm.dll |