InstallStatusMIFEx 関数
この関数はInstallStatusMIFEx、Configuration Managerで 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
製品またはプログラム名へのポインター (たとえば、Office 2000 Microsoft)。 このパラメーターは 64 文字に制限されています。
pszVersion
製品のバージョンへのポインター (例: 8.0a)。 このパラメーターは 64 文字に制限されています。
pszLocale
国/地域または言語コード (ENU など) へのポインター。 このパラメーターは省略可能で、16 文字に制限されています。
pszSerialNo
製品のシリアル番号へのポインター。 このパラメーターは省略可能で、64 文字に制限されています。
pszMessage
プログラムの状態メッセージに追加されるインストールの状態に関する説明メッセージへのポインター。 このパラメーターは 128 文字に制限されています。
bStatus
true インストールの状態が成功した場合。
bProgramReboots
true プログラムがコンピュータを再起動する場合。
戻り値
成功を示す 0 以外の値。
注釈
InstallStatusMIFEx は、 パラメーターの追加を InstallStatusMIF除き、 と機能的に bProgramReboot同等です。 再起動中にConfiguration Managerプロセスから正しい終了コードを取得できない可能性があるため、この情報をConfiguration Managerに渡す最も信頼性の高い方法は、 を使用bProgramRebootすることです。 プログラムの実行が完了した後に、プログラムがこのフラグを 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 Advanced Client が必要です。
ライブラリ: IsMIF32.dll (C/C++) にリソースとして含まれます。