Función MsiGetPatchInfoExA (msi.h)
La función MsiGetPatchInfoEx consulta información sobre la aplicación de una revisión en una instancia especificada de un producto.
Sintaxis
UINT MsiGetPatchInfoExA(
[in] LPCSTR szPatchCode,
[in] LPCSTR szProductCode,
[in] LPCSTR szUserSid,
[in] MSIINSTALLCONTEXT dwContext,
[in] LPCSTR szProperty,
[out, optional] LPSTR lpValue,
[in, out] LPDWORD pcchValue
);
Parámetros
[in] szPatchCode
Cadena terminada en null que contiene el GUID de la revisión. Este parámetro no puede ser NULL.
[in] szProductCode
Cadena terminada en null que contiene el GUID productCode de la instancia de producto. Este parámetro no puede ser NULL.
[in] szUserSid
Cadena terminada en null que especifica el identificador de seguridad (SID) en el que existe la instancia de la revisión que se consulta. El uso de un valor NULL especifica el usuario actual.
[in] dwContext
Restringe la enumeración a un contexto por usuario no administrado, por usuario o por máquina. Este parámetro puede ser cualquiera de los siguientes valores.
[in] szProperty
Cadena terminada en null que especifica el valor de propiedad que se va a recuperar. El parámetro szProperty puede ser uno de los siguientes:
| Nombre | Significado |
|---|---|
|
Obtiene el archivo de revisión almacenado en caché que usa el producto. |
|
Obtiene el conjunto de transformaciones de revisión que la última instalación de revisión aplicó al producto. Es posible que este valor no esté disponible para las aplicaciones no administradas por usuario si el usuario no ha iniciado sesión. |
|
Obtiene la última vez que este producto recibió el servicio. El valor de esta propiedad se reemplaza cada vez que se aplica o elimina una revisión del producto o se usa la opción de línea de comandos /v para reparar el producto. Si el producto no ha recibido reparaciones ni revisiones, esta propiedad contiene la hora en que este producto se instaló en este equipo. |
|
Devuelve "1" si la revisión está marcada como posible para desinstalar del producto. En este caso, el instalador de todos modos puede bloquear la desinstalación si otra revisión que no se puede desinstalar requiere esta revisión. |
|
Devuelve "1" si esta revisión se aplica actualmente al producto. Devuelve "2" si otra revisión sustituye a esta revisión. Devuelve "4" si esta revisión está obsoleta. Estos valores corresponden a las constantes que usa el parámetro dwFilter de MsiEnumPatchesEx . |
|
Obtenga el nombre para mostrar registrado para la revisión. En el caso de las revisiones que no incluyen la propiedad DisplayName en la tabla MsiPatchMetadata, el nombre para mostrar devuelto es una cadena vacía (""). |
|
Obtenga la dirección URL de información de soporte técnico registrada para la revisión. En el caso de las revisiones que no incluyen la propiedad MoreInfoURL en la tabla MsiPatchMetadata, la dirección URL de información de soporte técnico devuelta es una cadena vacía (""). |
[out, optional] lpValue
Este parámetro es un puntero a un búfer que recibe el valor de propiedad. Este búfer debe ser lo suficientemente grande como para contener la información. Si el búfer es demasiado pequeño, la función devuelve ERROR_MORE_DATA y establece *pcchValue en el número de TCHAR en el valor de propiedad, no incluido el carácter NULL de terminación.
Si lpValue se establece en NULL y pcchValue se establece en un puntero válido, la función devuelve ERROR_SUCCESS y establece *pcchValue en el número de TCHAR en el valor, no incluido el carácter NULL de terminación. A continuación, se puede llamar a la función de nuevo para recuperar el valor, con el búfer lpValue lo suficientemente grande como para contener *pcchValue + 1 caracteres.
Si lpValue y pcchValue se establecen en NULL, la función devuelve ERROR_SUCCESS si el valor existe, sin recuperar el valor.
[in, out] pcchValue
Al llamar a la función , este parámetro debe ser un puntero a una variable que especifica el número de TCHAR en el búfer lpValue . Cuando la función devuelve, este parámetro se establece en el tamaño del valor solicitado tanto si la función copia el valor en el búfer especificado. El tamaño se devuelve como el número de TCHAR en el valor solicitado, no incluido el carácter nulo de terminación.
Este parámetro solo se puede establecer en NULL si lpValue también es NULL. De lo contrario, la función devuelve ERROR_INVALID_PARAMETER.
Valor devuelto
La función MsiGetPatchInfoEx devuelve los valores siguientes.
| Código devuelto | Descripción |
|---|---|
|
La función no puede intentar acceder a un recurso con privilegios insuficientes. |
|
Los datos de configuración están dañados. |
|
Se produce un error en la función y el error no se identifica en otros códigos de error. |
|
Se pasa un parámetro no válido a la función . |
|
El valor no cabe en el búfer proporcionado. |
|
La revisión se enumera correctamente. |
|
El producto que especifica szProduct no está instalado en el equipo. |
|
No se reconoce la propiedad . |
|
No se reconoce la revisión. |
Comentarios
Windows Installer 2.0: No se admite. Esta función está disponible a partir de la versión 3.0 de Windows Installer.
Un usuario puede consultar los datos de revisión de cualquier instancia de producto visible. El grupo de administradores puede consultar datos de revisión para cualquier instancia de producto y cualquier usuario del equipo. No se garantiza que todos los valores estén disponibles para las aplicaciones no administradas por usuario si el usuario no ha iniciado sesión.
Nota:
El encabezado msi.h define MsiGetPatchInfoEx 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
| 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. Consulte Requisitos de Windows Installer en tiempo de ejecución 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 |