次の方法で共有

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 製品またはプログラム名へのポインター (Microsoft Office 2000 など)。 このパラメーターは 64 文字に制限されています。

pszVersion 製品のバージョンへのポインター (例: 8.0a)。 このパラメーターは 64 文字に制限されています。

pszLocale 国/地域または言語コード (ENU など) へのポインター。 このパラメーターは省略可能で、16 文字に制限されています。

pszSerialNo 製品のシリアル番号へのポインター。 このパラメーターは省略可能で、64 文字に制限されています。

pszMessage プログラムの状態メッセージに追加されるインストールの状態に関する説明メッセージへのポインター。 このパラメーターは 128 文字に制限されています。

bStatus true インストールの状態が成功した場合。

bProgramReboots true プログラムがコンピュータを再起動する場合。

戻り値

成功を示す 0 以外の値。

解説

InstallStatusMIFExは、bProgramRebootパラメーターの追加を除き、InstallStatusMIFと機能的に同等です。 再起動中Configuration Managerプロセスから正しい終了コードを取得できない可能性があるため、bProgramRebootを使用することは、この情報をConfiguration Managerに渡す最も信頼性の高い方法です。 プログラムの実行が完了した後、プログラムがこのフラグを MIF ファイルに設定し、再起動が行われなかった場合、Configuration Managerは 1 分間待ってから他のプログラムを起動します。 これにより、再起動が完了するのに十分な時間が得ることができます。 また、このフラグを使用すると、Configuration Managerはプログラムの事前成功状態メッセージを送信し、再起動後に最終的な成功状態メッセージを送信することもできます。

インストール (セットアップ) アプリケーションでは、パッケージのインストール状態 MIF ファイルを 1 つだけ作成する必要があります。 指定するファイル名は一意である必要があります。

Configuration Managerのローカライズされたバージョンで実行されるインストールでは、適切な形式で値を指定する必要があります。 ヨーロッパ言語の ANSI 形式。東アジア言語のJIS形式。

アプリケーションは、インストールが終了する前に InstallStatusMIFEx を呼び出す必要があります。 インストールによってInstallStatusMIFExを呼び出す別のプロセスが作成された場合、MIF ファイルはConfiguration Managerに報告されません。

パラメーターpszFilename、pszCompany、pszProduct、およびpszVersionは、それぞれMIFFileName、MIFPublisher、MIFName、およびMIFVersionSMS_Packageサーバー WMI クラスのプロパティに直接関連します。 これらのパラメーターとプロパティには、同じ値が含まれている必要があります。

要件

Windows NT/2000: Windows 2000 以降が必要です。

バージョン: SMS 2003 Advanced Client が必要です。

ライブラリ: IsMIF32.dll (C/C++) にリソースとして含まれます。

関連項目

Status MIF FunctionsInstallStatusMIFSMS_Package Server WMI クラス