InstallPerfDllA 関数 (loadperf.h)

入力 .ini ファイルで定義されているパフォーマンス カウンター文字列をシステム レジストリにインストールします。

メモ 開発者は、 InstallPerfDll ではなく LoadPerfCounterTextStringsを使用することをお勧めします。 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 バージョンを自動的に選択します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

必要条件

対象プラットフォーム	Windows
ヘッダー	loadperf.h
[DLL]	Loadperf.dll

関連項目

LoadPerfCounterTextStrings