Función MsiDetermineApplicablePatchesW (msi.h)

La función MsiDetermineApplicablePatches toma un conjunto de archivos de revisión, archivos XML y blobs XML y determina qué revisiones se aplican a un paquete de Windows Installer especificado y en qué secuencia. La función puede tener en cuenta las revisiones reemplazadas u obsoletas. Esta función no tiene en cuenta los productos o revisiones instalados en el sistema que no se especifican en el conjunto.

Sintaxis

UINT MsiDetermineApplicablePatchesW(
  [in] LPCWSTR                szProductPackagePath,
  [in] DWORD                  cPatchInfo,
  [in] PMSIPATCHSEQUENCEINFOW pPatchInfo
);

Parámetros

[in] szProductPackagePath

Ruta de acceso completa a un archivo .msi. La función determina las revisiones aplicables a este paquete y en qué secuencia.

[in] cPatchInfo

Número de revisiones de la matriz. Debe ser mayor que cero.

[in] pPatchInfo

Puntero a una matriz de estructuras MSIPATCHSEQUENCEINFO .

Valor devuelto

La función MsiDetermineApplicablePatches devuelve los valores siguientes.

Comentarios

Si se llama a esta función desde una acción personalizada, se produce un error y devuelve ERROR_CALL_NOT_IMPLEMENTED. La función requiere MSXML versión 3.0 para procesar XML y devuelve ERROR_CALL_NOT_IMPLEMENTED si MSXML 3.0 no está instalado.

La función MsiDetermineApplicablePatches establece los miembros uStatus y dwOrder de cada estructura MSIPATCHSEQUENCEINFO a la que apunta pPatchInfo. Cada estructura contiene información sobre una revisión determinada.

Si la función se realiza correctamente, la estructura MSIPATCHSEQUENCEINFO de cada revisión que se puede aplicar al producto devuelve con una uStatus de ERROR_SUCCESS y un dwOrder mayor o igual que cero. Los valores de dwOrder mayor o igual que cero indican la mejor secuencia de aplicación para las revisiones a partir de cero.

Si la función se realiza correctamente, las revisiones excluidas de la mejor secuencia de aplicación de revisiones devuelven una estructura MSIPATCHSEQUENCEINFO con dwOrder igual a -1. En estos casos, un campo uStatus de ERROR_SUCCESS indica una revisión obsoleta o reemplazada para el producto. Un campo uStatus de ERROR_PATCH_TARGET_NOT_FOUND indica una revisión que no se puede aplicar al producto.

Si se produce un error en la función, la estructura MSIPATCHSEQUENCEINFO de cada revisión devuelve un dwOrder igual a -1. En este caso, los campos uStatus pueden contener errores con más información sobre las revisiones individuales. Por ejemplo, ERROR_PATCH_NO_SEQUENCE se devuelve para las revisiones que tienen información de secuenciación circular.

Requisitos

Consulte también

MsiDeterminePatchSequence

No se admite en Windows Installer 2.0 ni en versiones anteriores

ProductCode