NetStatisticsGet-Funktion (lmstats.h)

Artikel
03/01/2024

Ruft Betriebsstatistiken für einen Dienst ab. Derzeit werden nur die Arbeitsstations- und Serverdienste unterstützt.

Syntax

NET_API_STATUS NET_API_FUNCTION NetStatisticsGet(
  [in]  LPTSTR ServerName,
  [in]  LPTSTR Service,
  [in]  DWORD  Level,
  [in]  DWORD  Options,
  [out] LPBYTE *Buffer
);

Parameter

[in] ServerName

Zeiger auf eine Zeichenfolge, die den DNS- oder NetBIOS-Namen des Servers angibt, auf dem die Funktion ausgeführt werden soll. Wenn dieser Parameter NULL ist, wird der lokale Computer verwendet.

[in] Service

Zeiger auf eine Zeichenfolge, die den Namen des Diensts angibt, über den die Statistiken abgerufen werden sollen. Derzeit sind nur die Werte SERVICE_SERVER und SERVICE_WORKSTATION zulässig.

[in] Level

Gibt die Informationsebene der Daten an. Dieser Parameter kann der folgende Wert sein.

Wert	Bedeutung
0	Zurückgeben von Statistiken zu einer Arbeitsstation oder einem Server. Der bufptr-Parameter verweist auf eine STAT_WORKSTATION_0 oder eine STAT_SERVER_0-Struktur .

[in] Options

Dieser Parameter muss null sein.

[out] Buffer

Zeiger auf den Puffer, der die Daten empfängt. Das Format dieser Daten hängt vom Wert des level-Parameters ab. Dieser Puffer wird vom System zugeordnet und muss mithilfe der NetApiBufferFree-Funktion freigegeben werden. Weitere Informationen finden Sie unter Netzwerkverwaltungsfunktionspuffer und Netzwerkverwaltungsfunktionspufferlängen.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert NERR_Success.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Systemfehlercode. Eine Liste der Fehlercodes finden Sie unter Systemfehlercodes.

Hinweise

Zum Abrufen von Arbeitsstationsstatistiken ist keine spezielle Gruppenmitgliedschaft erforderlich. Nur Mitglieder der lokalen Gruppe Administratoren oder Serveroperatoren können die NetStatisticsGet-Funktion erfolgreich auf einem Remoteserver ausführen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	lmstats.h (lm.h einschließen)
Bibliothek	Netapi32.lib
DLL	Netapi32.dll