Función MsiGetSummaryInformationA (msiquery.h)
La función msiGetSummaryInformation obtiene un identificador para el flujo de _SummaryInformation de una base de datos del instalador. Esta función devuelve un identificador que se debe cerrar mediante MsiCloseHandle.
Sintaxis
UINT MsiGetSummaryInformationA(
[in] MSIHANDLE hDatabase,
[in] LPCSTR szDatabasePath,
[in] UINT uiUpdateCount,
[out] MSIHANDLE *phSummaryInfo
);
Parámetros
[in] hDatabase
Identificador de la base de datos.
[in] szDatabasePath
Especifica la ruta de acceso a la base de datos.
[in] uiUpdateCount
Especifica el número máximo de valores actualizados.
[out] phSummaryInfo
Puntero a la ubicación desde la que se va a recibir el identificador de información de resumen.
Valor devuelto
La función MsiGetSummaryInformation devuelve los siguientes valores:
Observaciones
Si la base de datos especificada por la función MsiGetSummaryInformation no está abierta, debe especificar 0 para hDatabase y especificar la ruta de acceso a la base de datos en szDatabasePath. Si la base de datos está abierta, debe establecer szDatabasePath en 0.
Si se usa un valor de uiUpdateCount mayor que 0 para abrir una secuencia de información de resumen existente, se debe llamar a MsiSummaryInfoPersist antes de cerrar el identificador de phSummaryInfo. Si no se hace esto, se perderá la información de flujo existente.
Para ver la información de resumen de una revisión mediante MsiGetSummaryInformation, establezca szDatabasePath en la ruta de acceso a la revisión. Como alternativa, puede crear un identificador para la revisión mediante MsiOpenDatabase y, a continuación, pasar ese identificador a MsiGetSummaryInformation como parámetro hDatabase.
Tenga en cuenta que se recomienda usar variables de tipo PMSIHANDLE porque el instalador cierra los objetos PMSIHANDLE a medida que salen del ámbito, mientras que debe cerrar objetos MSIHANDLE llamando a MsiCloseHandle. Para obtener más información, vea la sección Usar PMSIHANDLE en lugar de HANDLE en la Procedimientos recomendados de Windows Installer.
Si se produce un error en la función, puede obtener información de error extendida mediante MsiGetLastErrorRecord.
Nota
El encabezado msiquery.h define MsiGetSummaryInformation como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows Installer 5.0 en Windows Server 2012, Windows 8, Windows Server 2008 R2 o Windows 7. Windows Installer 4.0 o Windows Installer 4.5 en Windows Server 2008 o Windows Vista. Windows Installer en Windows Server 2003 o Windows XP |
| de la plataforma de destino de |
Windows |
| encabezado de |
msiquery.h |
| biblioteca de |
Msi.lib |
| DLL de |
Msi.dll |