Função RtmGetRoutePointer (rtmv2.h)

A função RtmGetRoutePointer obtém um ponteiro direto para uma rota que permite ao proprietário do acesso de leitura da rota.

Sintaxe

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

[in] RtmRegHandle

Manipule para o cliente obtido de uma chamada anterior para RtmRegisterEntity.

[in] RouteHandle

Manipule para a rota.

[out] RoutePointer

Na entrada, RoutePointer é um ponteiro para NULL.

Na saída, o RoutePointer recebe um ponteiro para a rota.

Se a função for bem-sucedida, o valor retornado será NO_ERROR.

Se a função falhar, o valor retornado será um dos seguintes códigos de erro.

Valor	Significado
ERROR_ACCESS_DENIED	O cliente de chamada não possui essa rota.
ERROR_INVALID_HANDLE	O manipulador é inválido.

O ponteiro que foi retornado aponta para a parte pública da rota.

Requisito	Valor
Cliente mínimo com suporte	Nenhum compatível
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	rtmv2.h
Biblioteca	Rtm.lib
DLL	Rtm.dll

Esta página foi útil?