Função RtmCreateRouteList (rtmv2.h)

A função RtmCreateRouteList cria uma lista na qual o chamador pode manter uma cópia das rotas que possui.

Sintaxe

DWORD RtmCreateRouteList(
  [in]  RTM_ENTITY_HANDLE      RtmRegHandle,
  [out] PRTM_ROUTE_LIST_HANDLE RouteListHandle
);

[in] RtmRegHandle

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

[out] RouteListHandle

Na entrada, RouteListHandle é um ponteiro para NULL.

Na saída, RouteListHandle recebe um ponteiro para um identificador para a nova lista de rotas.

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

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

Valor	Significado
ERROR_NOT_ENOUGH_MEMORY	Não há memória suficiente para concluir essa operação.

Para obter o código de exemplo que usa essa função, consulte Usar uma lista de rotas Client-Specific.

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