Funzione RasAdminPortEnum

[Questa funzione viene fornita solo per la compatibilità con le versioni precedenti con Windows NT Server 4.0. Restituisce ERROR_CALL_NOT_IMPLEMENTED in Windows Server 2003. Le applicazioni devono usare la funzione MprAdminPortEnum .

La funzione RasAdminPortEnum enumera tutte le porte nel server RAS specificato. Per ogni porta nel server, la funzione restituisce la struttura RAS_PORT_0 contenente informazioni sulla porta.

Sintassi

DWORD RasAdminPortEnum(
  _In_  const WCHAR       *lpszServer,
  _Out_       PRAS_PORT_0 *ppRasPort0,
  _Out_       WORD        *pcEntriesRead
);

Parametri

lpszServer [in]

Puntatore a una stringa Unicode con terminazione null che specifica il nome del server RAS. Specificare il nome con caratteri "\\" iniziali, nel formato : \\servername.

ppRasPort0 [out]

Puntatore a una variabile che riceve un puntatore a un buffer contenente una matrice di strutture RAS_PORT_0 . Al termine dell'applicazione con la memoria, liberarla chiamando la funzione RasAdminFreeBuffer .

pcEntriesRead [out]

Puntatore a una variabile a 16 bit che riceve il numero totale di strutture RAS_PORT_0 restituite nella matrice ppRasPort0 .

Valore restituito

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

Se la funzione ha esito negativo, il valore restituito può essere il codice di errore seguente.

Valore	Significato
NERR_ItemNotFound	Non è possibile enumerare porte. Ciò potrebbe essere dovuto al fatto che tutte le porte configurate nel server sono attualmente in uso per la disconnessazione.

Non sono presenti informazioni di errore estese per questa funzione; non chiamare GetLastError.

Requisiti

Requisito	Valore
Fine del supporto client	Windows 2000 Professional
Fine del supporto server	Windows 2000 Server
Intestazione	Rassapi.h
Libreria	Rassapi.lib
DLL	Rassapi.dll

Vedi anche

Panoramica del servizio di accesso remoto (RAS)

Funzioni di amministrazione del server RAS

RAS_PORT_0

RasAdminFreeBuffer