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	控制代碼無效。

傳回的指標會指向路由的公用部分。