InstallStatusMIF 関数は、Configuration Manager が提供情報のインストール状態を関連付けるために使用する状態管理情報形式 (MIF) ファイルを作成します。
構文
DWORD InstallStatusMIF(
char* pszFileName,
char* pszCompany,
char* pszProduct,
char* pszVersion,
char* pszLocale,
char* pszSerialNo,
char* pszMessage,
BOOL bStatus
);
パラメーター
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 インストール状態が [成功] の場合。
戻り値
成功を示す 0 以外の値。
注釈
インストール (セットアップ) アプリケーションでは、パッケージのインストール状態 MIF ファイルを 1 つだけ作成する必要があります。 指定するファイル名は一意である必要があります。
Configuration Manager のローカライズされたバージョンで実行されるインストールでは、適切な形式で値を指定する必要があります。ヨーロッパ言語の場合は ANSI 形式。東アジア言語の DBCS 形式。
アプリケーションは、インストールを終了する前に InstallStatusMIF を呼び出す必要があります。 インストールによって InstallStatusMIF を呼び出す別のプロセスが作成される場合、MIF ファイルは Configuration Manager に報告されません。
パラメーター pszFilename、 pszCompany、 pszProduct、および pszVersion は、それぞれ SMS_Package Server WMI クラス のプロパティ MIFFileName、 MIFPublisher、 MIFName、および MIFVersion に直接関係していることに注意してください。 これらのパラメーターとプロパティには、同じ値が含まれている必要があります。
InstallStatusMIF関数は、32 ビット版 (Ismif32.dll) と 16 ビット版 (Ismif16.dll) があります。 Configuration Manager クライアント インストール プロセス中に、適切な DLL がクライアント コンピューターにインストールされます。
次のセクションの例では、Ismif32.dll ファイルを直接使用して InstallStatusMIF 関数を呼び出す方法を示します。 Ismif32.dll ファイルの読み込みに失敗した場合は、システムが Configuration Manager クライアントではないことが示されている可能性があります。
例
[C/C++]
DWORD (WINAPI *InstallStatusMIF)(char *, char *, char *, char *, char *, char *, char *, BOOL);
#define PROCSIGNATURE DWORD (WINAPI *)(char *, char *, char *, char *, char *, char *, char *, BOOL)
HINSTANCE hinst;
int RetCode;
hinst = LoadLibrary("ismif32.dll");
InstallStatusMIF = (PROCSIGNATURE) GetProcAddress(hinst, "InstallStatusMIF");
if (InstallStatusMIF)
{
RetCode = InstallStatusMIF("Status",
"Microsoft",
"Microsoft SQL Server 7.0",
"7.00.000",
"ENU",
NULL,
"Installation Successful",
true);
}
FreeLibrary(hinst);
要件
Windows NT/2000: Windows NT 4.0 以降が必要です。
Windows 95/98: Windows 95 以降が必要です。
バージョン: SMS 2.0 が必要です。
ライブラリ: Ismif32.dll (C/C++) のリソースとして含まれています。Ismif16.dll (C/C++)。