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 値への有効なポインターを指定します。 エクスポートできるメソッドの数を返すには、0 を指定します。
出力時に、 NumMethods は クライアントによってエクスポートされたメソッドの数を受け取ります。
[out] ExptMethods
呼び出し元クライアントによって要求された一連のメソッド識別子を含む RTM_ENTITY_EXPORT_METHOD 構造体へのポインターを受け取ります。
戻り値
関数が成功した場合、戻り値はNO_ERROR。
関数が失敗した場合、戻り値は次のいずれかのエラー コードになります。
値 | 意味 |
---|---|
|
指定されたバッファーは、要求されたすべての情報を保持するのに十分な大きさではありません。 |
注釈
別のクライアントのメソッドを直接呼び出さないでください。常に RtmInvokeMethod を使用します。 ルーティング テーブル マネージャーは 、RtmInvokeMethod を使用するときにエラー チェックを実行して、クライアントが登録を解除していないか、既に登録解除されていないことを確認します。
ERROR_INSUFFICIENT_BUFFERが返された場合は、 ExptMethods にデータが存在する可能性があります。 NumMethods は、 バッファーに実際に収まるメソッドの数を指定します。
エンティティ ハンドルが不要になったら、 RtmReleaseEntities を呼び出して解放します。
この関数を使用するサンプル コードについては、「 クライアントのエクスポートされたメソッドを取得して呼び出す」を参照してください。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | サポートなし |
サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | rtmv2.h |
Library | Rtm.lib |
[DLL] | Rtm.dll |