Compartir a través de

Función MsiGetPatchInfoExA (msi.h)

  • Artículo

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 ProductCode GUID de la instancia del 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.

SID Significado
NULL
 Especifica el usuario que ha iniciado sesión.
siD de usuario de
Especifica la enumeración de un identificador de usuario específico en el sistema. En el ejemplo siguiente se identifica un POSIBLE SID de usuario: "S-1-3-64-2415071341-1358098788-3127455600-2561".
 
Nota La cadena de SID especial "S-1-5-18" (sistema) no se puede usar para enumerar los productos instalados según la máquina. Si dwContext es MSIINSTALLCONTEXT_MACHINE, szUserSid debe ser NULL.
 

[in] dwContext

Restringe la enumeración a un contexto por usuario no administrado, administrado por usuario o por máquina. Este parámetro puede ser cualquiera de los siguientes valores.

Contexto Significado
MSIINSTALLCONTEXT_USERMANAGED
1
 Consulta extendida a todas las instalaciones administradas por usuario para los usuarios que szUserSid especifica.
MSIINSTALLCONTEXT_USERUNMANAGED
2
 Consulta extendida a todas las instalaciones por usuario no administradas para los usuarios que szUserSid especifica.
MSIINSTALLCONTEXT_MACHINE
4
 Consulta que se extiende a todas las instalaciones por máquina.

[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
INSTALLPROPERTY_LOCALPACKAGE
"LocalPackage"
 Obtiene el archivo de revisión almacenado en caché que usa el producto.
INSTALLPROPERTY_TRANSFORMS
"Transformaciones"
 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.
INSTALLPROPERTY_INSTALLDATE
"InstallDate"
 Obtiene la última vez que este producto recibió el servicio. El valor de esta propiedad se reemplaza cada vez que se aplica o quita un parche del producto o se usa la opción /v Command-Line para reparar el producto. Si el producto no ha recibido reparaciones o revisiones, esta propiedad contiene la hora en que se instaló este producto en este equipo.
INSTALLPROPERTY_UNINSTALLABLE
"Desinstalable"
 Devuelve "1" si la revisión está marcada como posible para desinstalar del producto. En este caso, el instalador todavía puede bloquear la desinstalación si otra revisión requiere esta revisión que no se puede desinstalar.
INSTALLPROPERTY_PATCHSTATE
"Estado"
 Devuelve "1" si esta revisión se aplica actualmente al producto. Devuelve "2" si esta revisión se sustituye por otra revisión. Devuelve "4" si esta revisión está obsoleta. Estos valores corresponden a las constantes que usa dwFilter parámetro de MsiEnumPatchesEx.
INSTALLPROPERTY_DISPLAYNAME
"DisplayName"
 Obtenga el nombre para mostrar registrado para la revisión. Para las revisiones que no incluyen la propiedad DisplayName en la tabla MsiPatchMetadata, el nombre para mostrar devuelto es una cadena vacía ("").
INSTALLPROPERTY_MOREINFOURL
"MoreInfoURL"
 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 al número de TCHAR en el valor de propiedad, sin incluir el carácter de de terminación NULL.

Si lpValue se establece en NULL y pcchValue se establece en un puntero válido, la función devuelve ERROR_SUCCESS y establece *pcchValue al número de TCHAR en el valor, no incluida la terminación carácter NULL. A continuación, se puede llamar a la función de nuevo para recuperar el valor, con lpValue búfer 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 de lpValue. Cuando se devuelve la función, este parámetro se establece en el tamaño del valor solicitado si la función copia o no el valor en el búfer especificado. El tamaño se devuelve como el número de TCHAR en el valor solicitado, sin incluir el carácter nulo de terminación.

Este parámetro se puede establecer en null solo 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
ERROR_ACCESS_DENIED
 La función no puede intentar acceder a un recurso con privilegios insuficientes.
ERROR_BAD_CONFIGURATION
 Los datos de configuración están dañados.
ERROR_FUNCTION_FAILED
 Se produce un error en la función y el error no se identifica en otros códigos de error.
ERROR_INVALID_PARAMETER
 Se pasa un parámetro no válido a la función .
ERROR_MORE_DATA
 El valor no cabe en el búfer proporcionado.
ERROR_SUCCESS
 La revisión se enumera correctamente.
ERROR_UNKNOWN_PRODUCT
 El producto que szProduct especifica no está instalado en el equipo.
ERROR_UNKNOWN_PROPERTY
 La propiedad no se reconoce.
ERROR_UNKNOWN_PATCH
 No se reconoce la revisión.

Observaciones

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 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. Consulte Windows Installer Run-Time Requirements (Requisitos de Windows Installer) para obtener información sobre el Service Pack mínimo de Windows que requiere una versión de Windows Installer.
de la plataforma de destino de Windows
encabezado de msi.h
biblioteca de Msi.lib
DLL de Msi.dll

Consulte también

productCode

quitar revisiones