Funzione RtmCreateRouteListEnum (rtmv2.h)

La funzione RtmCreateRouteListEnum crea un'enumerazione di route nell'elenco di route specificato.

Sintassi

DWORD RtmCreateRouteListEnum(
  [in]  RTM_ENTITY_HANDLE     RtmRegHandle,
  [in]  RTM_ROUTE_LIST_HANDLE RouteListHandle,
  [out] PRTM_ENUM_HANDLE      RtmEnumHandle
);

Parametri

[in] RtmRegHandle

Gestire il client ottenuto da una chiamata precedente a RtmRegisterEntity.

[in] RouteListHandle

Gestire l'elenco di route per enumerare ottenuto da una chiamata precedente a RtmCreateRouteList.

[out] RtmEnumHandle

In input , RtmEnumHandle è un puntatore a NULL.

Nell'output , RtmEnumHandle riceve un puntatore a un handle per l'enumerazione. Usare questo handle in tutte le chiamate successive alle funzioni che enumera l'elenco di route.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è NO_ERROR.

Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti.

Valore	Significato
ERROR_NOT_ENOUGH_MEMORY	Memoria insufficiente per completare questa operazione.

 

 

Commenti

Quando l'handle di enumerazione non è più necessario, rilasciarlo chiamando RtmDeleteEnumHandle.

Per il codice di esempio che usa questa funzione, vedere Usare un elenco di route Client-Specific.

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	rtmv2.h
Libreria	Rtm.lib
DLL	Rtm.dll

Vedi anche

RtmDeleteEnumHandle

RtmGetListEnumRoutes