InstallStatusMIF, funkcja
Funkcja InstallStatusMIF tworzy plik MIF (Management Information Format), który Configuration Manager używany do skorelowania stanu instalacji anonsu.
Składni
DWORD InstallStatusMIF(
char* pszFileName,
char* pszCompany,
char* pszProduct,
char* pszVersion,
char* pszLocale,
char* pszSerialNo,
char* pszMessage,
BOOL bStatus
);
Parametry
pszFileName
Wskaźnik do unikatowej nazwy pliku MIF. Rozszerzenie nazwy pliku musi mieć nazwę mif. Funkcja zapisuje plik w katalogu %TEMP%.
pszCompany
Wskaźnik do producenta lub wydawcy produktu, na przykład Microsoft. Ten parametr jest ograniczony do 64 znaków.
pszProduct
Wskaźnik do nazwy produktu lub programu, na przykład Microsoft office 2000. Ten parametr jest ograniczony do 64 znaków.
pszVersion
Wskaźnik do wersji produktu, na przykład 8.0a. Ten parametr jest ograniczony do 64 znaków.
pszLocale
Wskaźnik do kraju/regionu lub kodu języka, na przykład ENU. Ten parametr jest opcjonalny i jest ograniczony do 16 znaków.
pszSerialNo
Wskaźnik do numeru seryjnego produktu. Ten parametr jest opcjonalny i jest ograniczony do 64 znaków.
pszMessage
Wskaźnik do opisowego komunikatu o stanie instalacji, dodany do komunikatu o stanie programu. Ten parametr jest ograniczony do 128 znaków.
bStatus
true jeśli stan instalacji jest pomyślny.
Wartości zwracane
Wartość niezerowa wskazująca powodzenie.
Uwagi
Aplikacja instalacka (instalacka) musi utworzyć tylko jeden plik MIF stanu instalacji dla pakietu. Określona nazwa pliku musi być unikatowa.
Instalacje uruchamiane w zlokalizowanych wersjach Configuration Manager muszą określać wartości w odpowiednim formacie: format ANSI dla języków europejskich; Format DBCS dla języków Azji Wschodniej.
Aplikacja musi zostać wywołana InstallStatusMIF przed zakończeniem instalacji. Plik MIF nie jest zgłaszany do Configuration Manager, jeśli instalacja tworzy inny proces, który wywołuje .InstallStatusMIF
Należy pamiętać, że parametry pszFilename, pszCompany, pszProduct, i pszVersion są bezpośrednio związane z właściwościami MIFFileNameklasy WMI serwera SMS_Package, odpowiednio , MIFPublisher, MIFNamei MIFVersion. Te parametry i właściwości muszą zawierać te same wartości.
Funkcja InstallStatusMIF jest udostępniana w wersji 32-bitowej (Ismif32.dll) i wersji 16-bitowej (Ismif16.dll). Odpowiednia biblioteka DLL jest zainstalowana na komputerze klienckim podczas procesu instalacji klienta Configuration Manager.
W przykładzie w następnej sekcji pokazano, jak wywołać funkcję InstallStatusMIF bezpośrednio przy użyciu pliku Ismif32.dll. Niepowodzenie ładowania pliku Ismif32.dll może wskazywać, że system nie jest klientem Configuration Manager.
Przykład
[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);
Wymagania
Windows NT/2000: Wymaga systemu Windows NT 4.0 lub nowszego.
Windows 95/98: wymaga systemu Windows 95 lub nowszego.
Wersja: wymaga programu SMS 2.0.
Biblioteka: dołączona jako zasób w Ismif32.dll (C/C++); Ismif16.dll (C/C++).