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; DBCS formato para los 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.

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

Status MIF FunctionsInstallStatusMIFSMS_Package clase WMI de servidor