RasAdminPortEnum-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 MprAdminPortEnum-Funktion verwenden.]
Die RasAdminPortEnum-Funktion listet alle Ports auf dem angegebenen RAS-Server auf. Für jeden Port auf dem Server gibt die Funktion die RAS_PORT_0-Struktur zurück, die Informationen zum Port enthält.
Syntax
DWORD RasAdminPortEnum(
_In_ const WCHAR *lpszServer,
_Out_ PRAS_PORT_0 *ppRasPort0,
_Out_ WORD *pcEntriesRead
);
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.
-
ppRasPort0 [out]
-
Zeiger auf eine Variable, die einen Zeiger auf einen Puffer empfängt, der ein Array von RAS_PORT_0 Strukturen enthält. Wenn die Anwendung mit dem Arbeitsspeicher fertig ist, geben Sie ihn frei, indem Sie die RasAdminFreeBuffer-Funktion aufrufen.
-
pcEntriesRead [out]
-
Zeiger auf eine 16-Bit-Variable, die die Gesamtzahl der im ppRasPort0-Array zurückgegebenen RAS_PORT_0-Strukturen empfängt.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.
Wenn die Funktion fehlschlägt, kann der Rückgabewert der folgende Fehlercode sein.
| Wert | Bedeutung |
|---|---|
|
Es konnten keine Ports aufgelistet werden. Dies kann daran liegen, dass derzeit alle konfigurierten Ports auf dem Server für die Einwahl verwendet werden. |
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 |
|