Функция InstallStatusMIFEx

Статья
04/04/2023

Функция InstallStatusMIFEx в Configuration Manager расширяет функциональные возможности InstallStatusMIF.

Синтаксис

DWORD InstallStatusMIFEx(  
     char* pszFileName,  
     char* pszCompany,  
     char* pszProduct,  
     char* pszVersion,  
     char* pszLocale,  
     char* pszSerialNo,  
     char* pszMessage,  
     BOOL bStatus,  
     BOOL bProgramReboots  
);

Параметры

pszFileName
Указатель на уникальное имя файла MIF. Расширение имени файла должно иметь значение .mif. Функция записывает файл в каталог %TEMP%.

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

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

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

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

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

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

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

bProgramReboots
true значение , если программа перезагрузит компьютер.

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

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

Замечания

InstallStatusMIFEx Функционально эквивалентен InstallStatusMIF, за исключением добавления bProgramRebootпараметра . Использование bProgramRebootявляется наиболее надежным способом передачи этих сведений в Configuration Manager, так как во время перезагрузки Configuration Manager может не получить правильный код выхода из процесса. Если после завершения выполнения программы программа устанавливает этот флаг в MIF-файле и перезагрузка не произошла, Configuration Manager ожидает одну минуту перед запуском любой другой программы. Это дает достаточно времени для завершения перезагрузки. Этот флаг также позволяет Configuration Manager отправлять предварительное сообщение об успешном выполнении программы, а затем окончательное сообщение о состоянии успешного выполнения после перезагрузки.

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

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

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

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

Требования

Windows NT/2000: требуется Windows 2000 или более поздняя версия.

Версия: требуется расширенный клиент SMS 2003.

Библиотека: входит в состав ресурса в IsMIF32.dll (C/C++).

См. также

Функции MIF состояния
InstallStatusMIF
Класс WMI сервера SMS_Package

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