InstallPerfDllA 函式 (loadperf.h)

將輸入 .ini 檔案中所定義的效能計數器字串安裝到系統登錄中。

注意 Microsoft 建議開發人員使用 LoadPerfCounterTextStrings ，而不是 InstallPerfDll。 LoadPerfCounterTextStrings 會在內部呼叫 InstallPerfDll 。

語法

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

[in] szComputerName

系統的名稱。這應該是 Null ，因為此函式無法用於遠端安裝。

[in] lpIniFile

初始化檔的名稱，其中包含要新增至登錄的定義。

[in] dwFlags

這個參數可以 LOADPERF_FLAGS_DISPLAY_USER_MSGS ((ULONG_PTR) 8) 。

如果函式成功，它會傳回 TRUE ，並在應用程式事件記錄檔中張貼其他資訊。否則，它會傳回錯誤碼，代表造成失敗的條件。

此函式沒有相關聯的匯入程式庫;您必須使用 LoadLibrary 和 GetProcAddress 函式呼叫它。

注意

loadperf.h 標頭會將 InstallPerfDll 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程式碼，可能會導致編譯或執行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。