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 |