Função RtmGetListEnumRoutes (rtmv2.h)
A função RtmGetListEnumRoutes enumera um conjunto de rotas em uma lista de rotas especificada.
Sintaxe
DWORD RtmGetListEnumRoutes(
[in] RTM_ENTITY_HANDLE RtmRegHandle,
[in] RTM_ENUM_HANDLE EnumHandle,
[in, out] PUINT NumRoutes,
[out] PRTM_ROUTE_HANDLE RouteHandles
);
Parâmetros
[in] RtmRegHandle
Identificador para o cliente obtido de uma chamada anterior para RtmRegisterEntity.
[in] EnumHandle
Manipule para a lista de rotas a ser enumerada.
[in, out] NumRoutes
Na entrada, NumRoutes é um ponteiro para um valor UINT que especifica o número máximo de rotas que podem ser recebidas por RouteHandles.
Na saída, o NumRoutes recebe o número real de rotas recebidas por RouteHandles.
[out] RouteHandles
Na entrada, DestInfo é um ponteiro para uma matriz de estruturas RTM_DEST_INFO .
Na saída, DestInfo é preenchido com as informações de destino solicitadas.
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 códigos de erro a seguir.
| Valor | Significado |
|---|---|
|
O valor apontado por NumRoutes é maior do que o número máximo de rotas que um cliente tem permissão para recuperar com uma chamada. Verifique RTM_REGN_PROFILE o número máximo de rotas que o cliente tem permissão para recuperar com uma chamada. |
Comentários
Chame essa função repetidamente para recuperar todas as rotas.
Não há mais rotas para enumerar quando o gerenciador de tabelas de roteamento retorna zero em NumRoutes.
Para obter o código de exemplo que usa essa função, consulte Usar uma lista de rotas Client-Specific.
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 |