Fungsi InstallPerfDllA (loadperf.h)

Menginstal string penghitung kinerja, seperti yang didefinisikan dalam file .ini input, ke dalam registri sistem.

Note Microsoft merekomendasikan agar pengembang menggunakan LoadPerfCounterTextStrings alih-alih InstallPerfDll. loadPerfCounterTextStrings memanggil InstallPerfDll secara internal.

 

Sintaksis

LOADPERF_FUNCTION InstallPerfDllA(
  [in] LPCSTR    szComputerName,
  [in] LPCSTR    lpIniFile,
  [in] ULONG_PTR dwFlags
);

Parameter

[in] szComputerName

Nama sistem. Ini harus null karena fungsi ini tidak dapat digunakan untuk menginstal dari jarak jauh.

[in] lpIniFile

Nama file inisialisasi yang berisi definisi untuk ditambahkan ke registri.

[in] dwFlags

Parameter ini dapat LOADPERF_FLAGS_DISPLAY_USER_MSGS ((ULONG_PTR) 8).

Mengembalikan nilai

Jika fungsi berhasil, fungsi mengembalikan TRUE dan memposting informasi tambahan dalam log peristiwa aplikasi. Jika tidak, kode kesalahan mengembalikan kode kesalahan yang mewakili kondisi yang menyebabkan kegagalan.

Komentar

Fungsi ini tidak memiliki pustaka impor terkait; Anda harus memanggilnya menggunakan LoadLibrary dan fungsi GetProcAddress .

Nota

Header loadperf.h mendefinisikan InstallPerfDll sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Syarat	Nilai
Platform Target	Windows
Header	loadperf.h
DLL	Loadperf.dll

Lihat juga

loadPerfCounterTextStrings