此函數會InstallStatusMIF建立狀態管理資訊格式 (MIF) 檔案Configuration Manager用來將廣告的安裝狀態相互關聯。
語法
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 如果安裝狀態為成功。
傳回值
表示成功的非零值。
註解
您的安裝 (安裝) 應用程式必須只為套件建立一個安裝狀態 MIF 檔案。 您指定的檔案名稱必須是唯一的。
在當地語系化版本的 Configuration Manager 上執行的安裝必須以適當的格式指定值：歐洲語言的 ANSI 格式;東亞語言的 DBCS 格式。
您的應用程式必須在安裝結束之前呼叫 InstallStatusMIF 。 如果安裝建立另一個呼叫 InstallStatusMIF的程序，則不會將 MIF 檔案報告給 Configuration Manager。
請注意，參數 pszFilename、 pszCompany和 pszProductpszVersion 分別與 SMS_Package Server WMI 類別屬性 MIFFileName、 MIFPublisher和 MIFNameMIFVersion直接相關。 這些參數和屬性必須包含相同的值。
函數 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++) 。