RtmGetRoutePointer 関数 (rtmv2.h)

RtmGetRoutePointer 関数は、ルートの所有者が読み取りアクセスを許可するルートへの直接ポインターを取得します。

構文

DWORD RtmGetRoutePointer(
  [in]  RTM_ENTITY_HANDLE RtmRegHandle,
  [in]  RTM_ROUTE_HANDLE  RouteHandle,
  [out] PRTM_ROUTE_INFO   *RoutePointer
);

[in] RtmRegHandle

RtmRegisterEntity の以前の呼び出しから取得したクライアントを処理します。

[in] RouteHandle

ルートへのハンドル。

[out] RoutePointer

入力時、 RoutePointer は NULL へのポインターです。

出力時に、 RoutePointer は ルートへのポインターを受け取ります。

関数が成功した場合、戻り値はNO_ERROR。

関数が失敗した場合、戻り値は次のいずれかのエラーコードになります。

値	意味
ERROR_ACCESS_DENIED	呼び出し元のクライアントはこのルートを所有していません。
ERROR_INVALID_HANDLE	ハンドルが正しくありません。

返されたポインターは、ルートのパブリック部分を指します。