SetupInitializeFileLogA 関数 (setupapi.h)
[この機能は、[要件] セクションに示されているオペレーティング システムで使用できます。 以降のバージョンでは、変更または使用できない場合があります。 SetupAPI は、アプリケーションのインストールに使用されなくなりました。 代わりに、Windows インストーラーを使用してアプリケーション インストーラーを開発します。 SetupAPI は、デバイス ドライバーのインストールに引き続き使用されます。
SetupInitializeFileLog 関数は、インストール操作と結果を記録するファイルを初期化します。 これは、システム ログで、Windows の一部としてインストールされているファイルやその他のファイルをシステムが追跡します。
構文
WINSETUPAPI HSPFILELOG SetupInitializeFileLogA(
[in] PCSTR LogFileName,
[in] DWORD Flags
);
パラメーター
[in] LogFileName
ログ ファイルとして使用するファイルのファイル名への省略可能なポインター。
null-terminated 文字列を使用する必要があります。
Flags にSPFILELOG_SYSTEMLOGが含まれていない場合は、LogFileName パラメーターを指定する必要があります。 flags にSPFILELOG_SYSTEMLOGが含まれている場合は、
[in] Flags
ログ ファイルの初期化を制御します。 このパラメーターには、次の値の組み合わせを指定できます。
SPFILELOG_SYSTEMLOG
システム ファイル ログを使用します。 SPFILELOG_QUERYONLYを指定し、LogFileName が指定されていない場合
SPFILELOG_FORCENEW
ログ ファイルが存在する場合は、上書きします。 ログ ファイルが存在し、このフラグが指定されていない場合は、インストールされている新しいファイルが既存のログ ファイルの一覧に追加されます。 SPFILELOG_SYSTEMLOGと組み合わせて指定しないでください。
SPFILELOG_QUERYONLY
クエリ専用のログ ファイルを開きます。
戻り値
この関数は、成功した場合にログ ファイルにハンドルを返します。 それ以外の場合、戻り値はINVALID_HANDLE_VALUEされ、ログに記録されたエラーは、GetLastErrorの呼び出しによって取得できます。
備考
手記
setupapi.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして SetupInitializeFileLog を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows XP [デスクトップ アプリのみ] |
| サポートされる最小サーバー | Windows Server 2003 [デスクトップ アプリのみ] |
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | setupapi.h |
| ライブラリ | Setupapi.lib |
| DLL | Setupapi.dll |
関連項目
SetupLogFile の
SetupTerminateFileLog の