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 |
|---|---|
|
La porta specificata non è valida. |
|
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 |
|
| Libreria |
|
| DLL |
|