Функция InstallStatusMIFEx

Функция 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 Указатель на название продукта или программы, например Microsoft 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++).

См. также

Status MIF FunctionsInstallStatusMIFSMS_Package класс WMI сервера