Función MsiEnumPatchesW (msi.h)

La función MsiEnumPatches enumera todas las revisiones que se han aplicado a un producto. La función devuelve el GUID de código de revisión para cada revisión que se ha aplicado al producto y devuelve una lista de transformaciones de cada revisión que se aplica al producto. Tenga en cuenta que las revisiones pueden tener muchas transformaciones solo algunas de las cuales son aplicables a un producto determinado. La lista de transformaciones se devuelve en el mismo formato que el valor de la propiedad TRANSFORMS .

NotapcchTransformsBuf no se establece en el número de caracteres copiados en lpTransformsBuf tras una devolución correcta de MsiEnumPatches.

 

Sintaxis

UINT MsiEnumPatchesW(
  [in]      LPCWSTR szProduct,
  [in]      DWORD   iPatchIndex,
  [out]     LPWSTR  lpPatchBuf,
  [out]     LPWSTR  lpTransformsBuf,
  [in, out] LPDWORD pcchTransformsBuf
);

Parámetros

[in] szProduct

Especifica el código de producto del producto para el que se van a enumerar las revisiones.

[in] iPatchIndex

Especifica el índice de la revisión que se va a recuperar. Este parámetro debe ser cero para la primera llamada a la función MsiEnumPatches y, a continuación, incrementarse para las llamadas posteriores.

[out] lpPatchBuf

Puntero a un búfer que recibe el GUID de la revisión. Este argumento es obligatorio.

[out] lpTransformsBuf

Puntero a un búfer que recibe la lista de transformaciones en la revisión que se aplica al producto. Este argumento es obligatorio y no puede ser Null.

[in, out] pcchTransformsBuf

Establezca en el número de caracteres copiados en lpTransformsBuf tras una devolución incorrecta de la función. No se establece para una devolución correcta. En la entrada, este es el tamaño completo del búfer, incluido un espacio para un carácter nulo de terminación. Si el búfer pasado es demasiado pequeño, el recuento devuelto no incluye el carácter nulo de terminación.

Valor devuelto

Valor	Significado
ERROR_BAD_CONFIGURATION	Los datos de configuración están dañados.
ERROR_INVALID_PARAMETER	Se pasó un parámetro no válido a la función.
ERROR_NO_MORE_ITEMS	No hay revisiones para devolver.
ERROR_SUCCESS	Se ha enumerado un valor.
ERROR_MORE_DATA	Un búfer es demasiado pequeño para contener los datos solicitados.

Comentarios

Para enumerar las revisiones, una aplicación debe llamar inicialmente a la función MsiEnumPatches con el parámetro iPatchIndex establecido en cero. A continuación, la aplicación debe incrementar el parámetro iPatchIndex y llamar a MsiEnumPatches hasta que no haya más productos (hasta que la función devuelva ERROR_NO_MORE_ITEMS).

Si el búfer es demasiado pequeño para contener los datos solicitados, MsiEnumPatches devuelve ERROR_MORE_DATA y pcchTransformsBuf contiene el número de caracteres copiados en lpTransformsBuf, sin contar el carácter Null.

Nota

El encabezado msi.h define MsiEnumPatches 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 Convenciones para prototipos de función.

Requisitos

Requisito	Value
Cliente mínimo compatible	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. Consulte Windows Installer para obtener información sobre el Service Pack mínimo de Windows que requiere una versión de Windows Installer.
Plataforma de destino	Windows
Encabezado	msi.h
Library	Msi.lib
Archivo DLL	Msi.dll