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 形式。東アジア言語のJIS形式。
アプリケーションは、インストールが終了する前に InstallStatusMIF を呼び出す必要があります。 インストールによってInstallStatusMIFを呼び出す別のプロセスが作成された場合、MIF ファイルはConfiguration Managerに報告されません。
パラメーター pszFilename、 pszCompany、 pszProduct、および pszVersion はそれぞれ、 SMS_Package サーバー WMI クラス のプロパティ MIFFileName、 MIFPublisher、 MIFName、および MIFVersionに直接関連しています。 これらのパラメーターとプロパティには、同じ値が含まれている必要があります。
InstallStatusMIF関数は、32 ビット バージョン (Ismif32.dll) と 16 ビット バージョン (Ismif16.dll) で提供されます。 クライアント のインストール プロセス中に、適切な DLL がクライアント コンピューターにインストールConfiguration Manager。
次のセクションの例では、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++)。