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
NERR_ItemNotFound	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	Rassapi.h
Bibliothek	Rassapi.lib
DLL	Rassapi.dll

Siehe auch

Übersicht über ras (Remote Access Service, RAS)

RAS-Server-Verwaltungsfunktionen

RAS_PORT_0

RasAdminFreeBuffer