RasAdminPortClearStatistics-Funktion

[Diese Funktion wird nur zur Abwärtskompatibilität mit Windows NT Server 4.0 bereitgestellt. Sie gibt unter Windows Server 2003 ERROR_CALL_NOT_IMPLEMENTED zurück. Anwendungen sollten die MprAdminPortClearStats-Funktion verwenden.]

Die RasAdminPortClearStatistics-Funktion setzt die Leistungsindikatoren für die verschiedenen Statistiken Wert, die von der RasAdminPortGetInfo-Funktion in der Struktur RAS\_PORT\_STATISTICS gemeldet wurden. Die Zähler werden auf null zurückgesetzt und beginnen mit der Akkumulation.

Syntax

DWORD RasAdminPortClearStatistics(
  _In_ const WCHAR *lpszServer,
  _In_ const WCHAR *lpszPort
);

Parameter

lpszServer [in]

Zeiger auf eine mit NULL beendete Unicode-Zeichenfolge, die den Namen des RAS-Servers angibt. Geben Sie den Namen mit führenden „\\“-Zeichen in der Form \\Servername an.

lpszPort [in]

Zeiger auf eine mit NULL beendete Unicode-Zeichenfolge, die den Namen des Ports auf dem Server angibt.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ERROR_SUCCESS.

Bei einem Fehler der Funktion kann der Rückgabewert der folgende Fehlercode sein.

Wert	Bedeutung
ERROR_DEV_NOT_EXIST	Der angegebene Port ist ungültig.

Für diese Funktion gibt es keine erweiterten Fehlerinformationen; rufen Sie GetLastError nicht auf.

Hinweise

Die RasAdminPortClearStatistics-Funktion löscht die Statistiken auf dem Server, nicht lokal in der Anwendung, die den Aufruf vornimmt. Dies bedeutet, dass die Statistiken auch für andere Anwendungen zurückgesetzt werden, die den angegebenen Port überwachen.

Wenn der Port lpszPort Teil einer Multilinkverbindung ist, setzt RasAdminPortClearStatistics die Statistiken für den angegebenen Port zurück. Die Funktion setzt auch die kumulativen Statistiken für die Multilinkverbindung zurück. Sie wirkt sich jedoch nicht auf die einzelnen Statistiken für andere Ports aus, die Teil der Multilinkverbindung sind.

Anforderungen

Anforderung	Wert
Ende des Clientsupports	Windows 2000 Professional
Ende der Serverunterstützung	Windows 2000 Server
Header	Rassapi.h
Bibliothek	Rassapi.lib
DLL	Rassapi.dll

Siehe auch

Übersicht über Remote Access Service (RAS)

RAS-Serververwaltungsfunktionen

RAS_PORT_STATISTICS

RasAdminPortGetInfo