Configuration Manager の InstallStatusMIFEx 関数は、InstallStatusMIF の機能を強化します。
構文
DWORD InstallStatusMIFEx(
char* pszFileName,
char* pszCompany,
char* pszProduct,
char* pszVersion,
char* pszLocale,
char* pszSerialNo,
char* pszMessage,
BOOL bStatus,
BOOL bProgramReboots
);
パラメーター
pszFileName 管理情報形式 (MIF) ファイルの一意の名前へのポインター。 ファイル名拡張子は .mif である必要があります。 関数はファイルを %TEMP% ディレクトリに書き込みます。
pszCompany 製品の製造元または発行元へのポインター (Microsoft など)。 このパラメーターは 64 文字に制限されています。
pszProduct 製品名またはプログラム名 (Microsoft Office 2000 など) へのポインター。 このパラメーターは 64 文字に制限されています。
pszVersion 製品のバージョンへのポインター (8.0a など)。 このパラメーターは 64 文字に制限されています。
pszLocale 国/地域または言語コード (ENU など) へのポインター。 このパラメーターは省略可能であり、16 文字に制限されています。
pszSerialNo 製品のシリアル番号へのポインター。 このパラメーターは省略可能であり、64 文字に制限されています。
pszMessage インストールの状態に関する説明メッセージへのポインター。プログラムの状態メッセージに追加されます。 このパラメーターは 128 文字に制限されています。
bStatus
true インストール状態が [成功] の場合。
bProgramReboots
true プログラムがコンピューターを再起動する場合。
戻り値
成功を示す 0 以外の値。
注釈
InstallStatusMIFExは、bProgramRebootパラメーターの追加を除き、機能的には InstallStatusMIF と同等です。
bProgramReboot を使用することは、この情報を Configuration Manager に渡す最も確実な方法です。再起動時にConfiguration Managerプロセスから正しい終了コードを取得できない可能性があるためです。 プログラムの実行が完了した後、プログラムが MIF ファイルにこのフラグを設定し、再起動が行われなかった場合、Configuration Manager は他のプログラムを起動する前に 1 分待機します。 これにより、再起動が完了するのに十分な時間が確保されます。 このフラグを使用すると、Configuration Manager はプログラムの暫定的な成功ステータス メッセージを送信し、再起動が発生した後に最終的な成功ステータス メッセージを送信することもできます。
インストール (セットアップ) アプリケーションでは、パッケージのインストール状態 MIF ファイルを 1 つだけ作成する必要があります。 指定するファイル名は一意である必要があります。
Configuration Manager のローカライズされたバージョンで実行されるインストールでは、適切な形式で値を指定する必要があります。ヨーロッパ言語の場合は ANSI 形式。東アジア言語の DBCS 形式。
アプリケーションは、インストールを終了する前に InstallStatusMIFEx を呼び出す必要があります。 インストールで InstallStatusMIFEx を呼び出す別のプロセスが作成された場合、MIF ファイルは Configuration Manager に報告されません。
パラメーター pszFilename、 pszCompany、 pszProduct、および pszVersion は、それぞれ SMS_Package サーバー WMI クラス のプロパティ MIFFileName、 MIFPublisher、 MIFName、および MIFVersion に直接関係します。 これらのパラメーターとプロパティには、同じ値が含まれている必要があります。
要件
Windows NT/2000: Windows 2000 以降が必要です。
バージョン: SMS 2003 アドバンスト クライアントが必要です。
ライブラリ: IsMIF32.dll (C/C++) のリソースとして含まれています。