Función MsiGetShortcutTargetW (msi.h)

La función MsiGetShortcutTarget examina un acceso directo y devuelve su producto, nombre de característica y componente si está disponible.

Sintaxis

UINT MsiGetShortcutTargetW(
  [in]  LPCWSTR szShortcutPath,
  [out] LPWSTR  szProductCode,
  [out] LPWSTR  szFeatureId,
  [out] LPWSTR  szComponentCode
);

Parámetros

[in] szShortcutPath

Cadena terminada en null que especifica la ruta de acceso completa a un acceso directo.

[out] szProductCode

GUID para el código de producto del acceso directo. Este búfer de cadena debe tener 39 caracteres. Los primeros 38 caracteres son para el GUID y el último carácter es para el carácter nulo de terminación. Este parámetro puede ser NULL.

[out] szFeatureId

Nombre de la característica del acceso directo. El búfer de cadena debe tener MAX_FEATURE_CHARS+1 caracteres. Este parámetro puede ser NULL.

[out] szComponentCode

GUID del código del componente. Este búfer de cadena debe tener 39 caracteres. Los primeros 38 caracteres son para el GUID y el último carácter es para el carácter nulo de terminación. Este parámetro puede ser NULL.

Valor devuelto

Esta función devuelve UINT.

Comentarios

Si se produce un error en la función y el acceso directo existe, se puede acceder al contenido normal del acceso directo a través de la interfaz IShellLink .

De lo contrario, el estado del destino puede determinarse mediante las funciones de selección del instalador.

Nota

El encabezado msi.h define MsiGetShortcutTarget 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en 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