Función InstallStatusMIFEx

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). La extensión de nombre de archivo debe ser .mif. La función escribe el archivo en el directorio %TEMP%.

pszCompany Puntero al fabricante o editor 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 país o región o código de 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

Un valor distinto de cero para indicar que se ha realizado correctamente.

Comentarios

InstallStatusMIFEx es funcionalmente equivalente a InstallStatusMIF, excepto por la adición del bProgramRebootparámetro. El uso bProgramRebootes la forma más segura de pasar esta información a Configuration Manager, ya que durante el reinicio es posible que Configuration Manager no pueda 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 deja suficiente tiempo para que finalice el reinicio. Esta marca también permite a Configuration Manager enviar un mensaje de estado preliminar de éxito para el programa y, después, un mensaje de estado final de éxito después de que se haya producido el reinicio.

La aplicación de instalación (configuración) debe crear solo 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 los valores en el formato apropiado: formato ANSI para los idiomas europeos; Formato DBCS para idiomas de Asia Oriental.

La aplicación debe llamar 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.

Los parámetros pszFilename, pszCompany, pszProduct, y pszVersion están directamente relacionados con las propiedades MIFFileNamede clase WMI de SMS_Package Server , MIFPublisher, MIFName, y 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 recurso en IsMIF32.dll (C/C++).

Consulta también

Estado MIF FunctionsInstallStatusMIFSMS_Package Server WMI Class