InstallStatusMIF 関数

  • [アーティクル]

この関数は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
製品またはプログラム名へのポインター (たとえば、Office 2000 Microsoft)。 このパラメーターは 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 サーバー 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++)。

関連項目

状態 MIF 関数
SMS_Package サーバー WMI クラス