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	핸들이 잘못되었습니다.

반환된 포인터는 경로의 공용 부분을 가리킵니다.