Funzione RasAdminPortGetInfo

[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 MprAdminPortGetInfo .]

La funzione RasAdminPortGetInfo recupera informazioni su una porta specificata in un server specificato.

Sintassi

DWORD RasAdminPortGetInfo(
  _In_  const WCHAR               *lpszServer,
  _In_  const WCHAR               *lpszPort,
  _Out_       RAS_PORT_1          *pRasPort1,
  _Out_       RAS_PORT_STATISTICS *pRasStats,
  _Out_       RAS_PARAMETERS      **ppRasParams
);

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 \\nomeserver.

lpszPort [in]

Puntatore a una stringa Unicode con terminazione Null che specifica il nome della porta nel server.

pRasPort1 [out]

Puntatore alla struttura RAS_PORT_1 che la funzione inserisce con informazioni sullo stato della porta.

pRasStats [out]

Puntatore alla struttura RAS_PORT_STATISTICS compilata dalla funzione con statistiche sulla porta.

ppRasParams [out]

Puntatore a una variabile puntatore che riceve l'indirizzo di una matrice di strutture RAS_PARAMETERS . Ogni struttura contiene il nome di una chiave specifica del supporto, ad esempio MAXCONNECTBPS, e il relativo valore associato. Al termine dell'applicazione con questa memoria, liberarla chiamando la funzione RasAdminFreeBuffer .

Valore restituito

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

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

Valore	Significato
ERROR_DEV_NOT_EXIST	La porta specificata non è valida.
ERROR_NOT_ENOUGH_MEMORY	Memoria insufficiente per allocare un buffer per la matrice ppRasParams .

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 accesso remoto (RAS)

Funzioni di amministrazione del server RAS

RAS_PARAMETERS

RAS_PORT_1

RAS_PORT_STATISTICS

RasAdminFreeBuffer