RasAdminPortGetInfo-Funktion
[Diese Funktion wird nur aus Gründen der Abwärtskompatibilität mit Windows NT Server 4.0 bereitgestellt. Es wird ERROR_CALL_NOT_IMPLEMENTED unter Windows Server 2003 zurückgegeben. Anwendungen sollten die MprAdminPortGetInfo-Funktion verwenden.]
Die RasAdminPortGetInfo-Funktion ruft Informationen zu einem angegebenen Port auf einem angegebenen Server ab.
Syntax
DWORD RasAdminPortGetInfo(
_In_ const WCHAR *lpszServer,
_In_ const WCHAR *lpszPort,
_Out_ RAS_PORT_1 *pRasPort1,
_Out_ RAS_PORT_STATISTICS *pRasStats,
_Out_ RAS_PARAMETERS **ppRasParams
);
Parameter
-
lpszServer [in]
-
Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die den Namen des RAS-Servers angibt. Geben Sie den Namen mit führenden "\\"-Zeichen im Format \\Servername an.
-
lpszPort [in]
-
Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die den Namen des Ports auf dem Server angibt.
-
pRasPort1 [out]
-
Zeiger auf die RAS_PORT_1 Struktur, die die Funktion mit Informationen zum Status des Ports ausfüllt.
-
pRasStats [out]
-
Zeiger auf die RAS_PORT_STATISTICS Struktur, die die Funktion mit Statistiken zum Port ausfüllt.
-
ppRasParams [out]
-
Zeiger auf eine Zeigervariable, die die Adresse eines Arrays von RAS_PARAMETERS Strukturen empfängt. Jede Struktur enthält den Namen eines medienspezifischen Schlüssels, z. B. MAXCONNECTBPS, und den zugehörigen Wert. Wenn die Anwendung mit diesem Arbeitsspeicher fertig ist, geben Sie ihn frei, indem Sie die RasAdminFreeBuffer-Funktion aufrufen.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.
Wenn die Funktion fehlschlägt, kann der Rückgabewert einer der folgenden Fehlercodes sein.
| Wert | Bedeutung |
|---|---|
|
Der angegebene Port ist ungültig. |
|
Unzureichender Arbeitsspeicher zum Zuordnen eines Puffers für das ppRasParams-Array . |
Es gibt keine erweiterten Fehlerinformationen für diese Funktion. Rufen Sie GetLastError nicht auf.
Anforderungen
| Anforderung | Wert |
|---|---|
| Ende des Supports (Client) |
Windows 2000 Professional |
| Ende des Supports (Server) |
Windows 2000 Server |
| Header |
|
| Bibliothek |
|
| DLL |
|