InstallStatusMIF 函式
函 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 的進程，則不會向Configuration Manager報告 MIF 檔案。
請注意，、 pszCompany 、 pszProduct 和 pszVersion 參數 pszFilename 分別與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++) 。