Función InstallStatusMIF

La InstallStatusMIF función crea un archivo de formato de información de administración (MIF) de estado que Configuration Manager utiliza 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 FOMIN. 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, 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

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

Comentarios

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

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

En el ejemplo de la siguiente sección se muestra cómo llamar a la InstallStatusMIF función utilizando el archivo Ismif32.dll directamente. Un error al cargar el archivo Ismif32.dll podría 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: Incluido como recurso en Ismif32.dll (C/C++); Ismif16.dll (C/C++).

Consulta también

Funciones MIF de estado ClaseWMI de servidor SMS_Package