Función InstallStatusMIF

La InstallStatusMIF función crea un archivo de formato de información de administración de estado (MIF) que Configuration Manager usa para correlacionar el estado de instalación de un anuncio.

Sintaxis

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

Parámetros

pszFileName
Puntero a un nombre único para el archivo 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, agregado al mensaje de estado del programa. Este parámetro está limitado a 128 caracteres.

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

Valores devueltos

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

Comentarios

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 InstallStatusMIF 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 InstallStatusMIF.

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.

La InstallStatusMIF función se proporciona en una versión de 32 bits (Ismif32.dll) y una versión de 16 bits (Ismif16.dll). El archivo DLL adecuado se instala en el equipo cliente durante el proceso de instalación del cliente Configuration Manager.

En el ejemplo de la sección siguiente se muestra cómo llamar a la InstallStatusMIF función mediante el archivo Ismif32.dll directamente. Un error al cargar el archivo Ismif32.dll puede indicar que el sistema no es un cliente Configuration Manager.

Ejemplo

[C/C++]  
DWORD (WINAPI *InstallStatusMIF)(char *, char *, char *, char *, char *, char *, char *, BOOL);  

#define PROCSIGNATURE DWORD (WINAPI *)(char *, char *, char *, char *, char *, char *, char *, BOOL)  

    HINSTANCE  hinst;  
    int  RetCode;  

    hinst = LoadLibrary("ismif32.dll");  

    InstallStatusMIF = (PROCSIGNATURE) GetProcAddress(hinst, "InstallStatusMIF");  

    if (InstallStatusMIF)  
    {  
        RetCode = InstallStatusMIF("Status",  
                                   "Microsoft",  
                                   "Microsoft SQL Server 7.0",  
                                   "7.00.000",  
                                   "ENU",  
                                   NULL,  
                                   "Installation Successful",  
                                   true);  
    }  
    FreeLibrary(hinst);   

Requisitos

Windows NT/2000: requiere Windows NT 4.0 o posterior.

Windows 95/98: requiere Windows 95 o posterior.

Versión: requiere SMS 2.0.

Biblioteca: se incluye como un recurso en Ismif32.dll (C/C++); Ismif16.dll (C/C++).

Consulta también

Funciones de MIF de estado
SMS_Package clase WMI de servidor