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
);
Parâmetros
[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.
Retornar valor
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 |
|---|---|
|
O cliente de chamada não possui essa rota. |
|
O manipulador é inválido. |
Comentários
O ponteiro que foi retornado aponta para a parte pública da rota.
Requisitos
| 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 |