函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 格式;BIG5 東亞語言的格式。
您的應用程式必須在安裝結束之前呼叫 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++) 。