Функция MsiGetShortcutTargetW (msi.h)

Статья
11/20/2024

Функция msiGetShortcutTarget проверяет ярлык и возвращает его продукт, имя компонента и компонент, если он доступен.

Синтаксис

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

Параметры

[in] szShortcutPath

Строка, завершающаяся значением NULL, указывающая полный путь к ярлыку.

[out] szProductCode

GUID для кода продукта ярлыка. Этот буфер строки должен иметь длину 39 символов. Первые 38 символов предназначены для GUID, а последний — для конца null- символа. Этот параметр может иметь значение NULL.

[out] szFeatureId

Имя функции ярлыка. Буфер строки должен иметь длину MAX_FEATURE_CHARS+1 символов. Этот параметр может иметь значение NULL.

[out] szComponentCode

GUID кода компонента. Этот буфер строки должен иметь длину 39 символов. Первые 38 символов предназначены для GUID, а последний — для конца null- символа. Этот параметр может иметь значение NULL.

Возвращаемое значение

Эта функция возвращает UINT.

Замечания

Если функция завершается ошибкой, и ярлык существует, доступ к регулярному содержимому ярлыка можно получить через интерфейс IShellLink.

В противном случае состояние целевого объекта можно определить с помощью функции выбора установщика.

Заметка

Заголовок msi.h определяет MsiGetShortcutTarget как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Установщик Windows 5.0 в Windows Server 2012, Windows 8, Windows Server 2008 R2 или Windows 7. Установщик Windows 4.0 или установщик Windows 4.5 в Windows Server 2008 или Windows Vista. Установщик Windows в Windows Server 2003 или Windows XP. Сведения о минимальном пакете обновления Windows, требуемом версией установщика Windows, см. в разделе "Требования к установщику Windows Run-Time".
целевая платформа	Виндоус
заголовка	msi.h
библиотеки	Msi.lib
DLL	Msi.dll

Поделиться через