InstallStatusMIFEx (función)

La InstallStatusMIFEx función, en Configuration Manager, mejora la funcionalidad de InstallStatusMIF.

Sintaxis

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

Parámetros

pszFileName
Puntero a un nombre único para el archivo de formato de información de administración (MIF). Una extensión de nombre de archivo debe ser .mif. La función escribe el archivo en el directorio %TEMP%.

pszCompany
Puntero al fabricante o publicador del producto, por ejemplo, Microsoft. Este parámetro está limitado a 64 caracteres.

pszProduct
Puntero al nombre del producto o programa, por ejemplo, Microsoft Office 2000. Este parámetro está limitado a 64 caracteres.

pszVersion
Puntero a la versión del producto, por ejemplo, 8.0a. Este parámetro está limitado a 64 caracteres.

pszLocale
Puntero al código de país o región o idioma, por ejemplo, ENU. Este parámetro es opcional y está limitado a 16 caracteres.

pszSerialNo
Puntero al número de serie del producto. Este parámetro es opcional y está limitado a 64 caracteres.

pszMessage
Puntero a un mensaje descriptivo sobre el estado de la instalación, que se agrega al mensaje de estado del programa. Este parámetro está limitado a 128 caracteres.

bStatus
true si el estado de instalación es correcto.

bProgramReboots
true si el programa reiniciará el equipo.

Valores devueltos

Valor distinto de cero para indicar que se ha realizado correctamente.

Comentarios

InstallStatusMIFEx es funcionalmente equivalente a InstallStatusMIF, excepto para la adición del bProgramRebootparámetro . El uso bProgramRebootes la forma más confiable de pasar esta información a Configuration Manager, ya que durante el reinicio Configuration Manager podría no poder obtener el código de salida correcto del proceso. Si, después de completar la ejecución del programa, el programa establece esta marca en el archivo MIF y no se ha producido un reinicio, Configuration Manager espera un minuto antes de iniciar cualquier otro programa. Esto permite tiempo suficiente para que finalice el reinicio. Esta marca también permite a Configuration Manager enviar un mensaje de estado de éxito preliminar para el programa y, a continuación, un mensaje de estado de éxito final después de que se haya producido el reinicio.

La aplicación de instalación (instalación) solo debe crear un archivo MIF de estado de instalación para el paquete. El nombre de archivo que especifique debe ser único.

Las instalaciones que se ejecutan en versiones localizadas de Configuration Manager deben especificar valores en el formato adecuado: formato ANSI para idiomas europeos; Formato DBCS para idiomas del este de Asia.

La aplicación debe llamar a InstallStatusMIFEx antes de que se cierre la instalación. El archivo MIF no se notifica a Configuration Manager si la instalación crea otro proceso que llama a InstallStatusMIFEx.

Tenga en cuenta que los parámetros pszFilename, pszCompany, pszProducty pszVersion están directamente relacionados con las propiedades MIFFileNameSMS_Package clase WMI de servidor , MIFPublisher, MIFNamey MIFVersion, respectivamente. Estos parámetros y propiedades deben contener los mismos valores.

Requisitos

Windows NT/2000: requiere Windows 2000 o posterior.

Versión: requiere el cliente avanzado de SMS 2003.

Biblioteca: se incluye como un recurso en IsMIF32.dll (C/C++).

Consulta también

Funciones de MIF de estado
InstallStatusMIF
SMS_Package clase WMI de servidor