Fungsi NetStatisticsGet (lmstats.h)

Artikel
03/04/2024

Mengambil statistik operasi untuk layanan. Saat ini, hanya stasiun kerja dan layanan server yang didukung.

Sintaks

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

Penunjuk ke string yang menentukan nama DNS atau NetBIOS server tempat fungsi dijalankan. Jika parameter ini NULL, komputer lokal akan digunakan.

[in] Service

Penunjuk ke string yang menentukan nama layanan yang akan mendapatkan statistik. Hanya nilai yang SERVICE_SERVER dan SERVICE_WORKSTATION yang saat ini diizinkan.

[in] Level

Menentukan tingkat informasi data. Parameter ini bisa menjadi nilai berikut.

Nilai	Makna
0	Mengembalikan statistik tentang stasiun kerja atau server. Parameter bufptr menunjuk ke STAT_WORKSTATION_0 atau struktur STAT_SERVER_0 .

[in] Options

Parameter ini harus nol.

[out] Buffer

Arahkan ke buffer yang menerima data. Format data ini tergantung pada nilai parameter tingkat . Buffer ini dialokasikan oleh sistem dan harus dikosongkan menggunakan fungsi NetApiBufferFree . Untuk informasi selengkapnya, lihat Buffer Fungsi Manajemen Jaringan dan Panjang Buffer Fungsi Manajemen Jaringan.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah NERR_Success.

Jika fungsi gagal, nilai yang dikembalikan adalah kode kesalahan sistem. Untuk daftar kode kesalahan, lihat Kode Kesalahan Sistem.

Keterangan

Tidak ada keanggotaan grup khusus yang diperlukan untuk mendapatkan statistik stasiun kerja. Hanya anggota grup lokal Administrator atau Operator Server yang berhasil menjalankan fungsi NetStatisticsGet di server jarak jauh.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	lmstats.h (termasuk Lm.h)
Pustaka	Netapi32.lib
DLL	Netapi32.dll