Функция InstallStatusMIF

Статья
04/04/2023

Функция 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
Указатель на производителя или издателя продукта, например Майкрософт. Этот параметр ограничен 64 символами.

pszProduct
Указатель на название продукта или программы, например Майкрософт Office 2000. Этот параметр ограничен 64 символами.

pszVersion
Указатель на версию продукта, например 8.0a. Этот параметр ограничен 64 символами.

pszLocale
Указатель на код страны или региона или языка, например ENU. Этот параметр является необязательным и ограничен 16 символами.

pszSerialNo
Указатель на серийный номер продукта. Этот параметр является необязательным и ограничен 64 символами.

pszMessage
Указатель на описательное сообщение о состоянии установки, добавленное в сообщение о состоянии программы. Этот параметр ограничен 128 символами.

bStatus
true Значение , если состояние установки выполнено успешно.

Возвращаемые значения

Ненулевое значение, указывающее на успешное выполнение.

Замечания

Приложение установки (установки) должно создать только один MIF-файл состояния установки для пакета. Указанное имя файла должно быть уникальным.

Установки, выполняемые в локализованных версиях Configuration Manager, должны указывать значения в соответствующем формате: формат ANSI для европейских языков; Формат DBCS для языков Восточной Азии.

Приложение должно вызвать InstallStatusMIF перед завершением установки. MIF-файл не передается Configuration Manager, если при установке создается другой процесс, вызывающий InstallStatusMIF.

Обратите внимание, что параметры pszFilename, pszCompany, pszProductи pszVersion напрямую связаны со свойствами MIFFileNameкласса WMI сервера SMS_Package , MIFPublisher, MIFNameи MIFVersionсоответственно. Эти параметры и свойства должны содержать одни и те же значения.

Функция InstallStatusMIF предоставляется в 32-разрядной версии (Ismif32.dll) и 16-разрядной версии (Ismif16.dll). Соответствующая библиотека DLL устанавливается на клиентском компьютере в процессе установки клиента Configuration Manager.

В следующем разделе показано, как вызвать функцию InstallStatusMIF с помощью файла Ismif32.dll напрямую. Сбой при загрузке файла 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 состояния
Класс WMI сервера SMS_Package

Поделиться через