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

  • Статья

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

Синтаксис

UINT MsiGetShortcutTargetA(
  [in]  LPCSTR szShortcutPath,
  [out] LPSTR  szProductCode,
  [out] LPSTR  szFeatureId,
  [out] LPSTR  szComponentCode
);

Параметры

[in] szShortcutPath

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

[out] szProductCode

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

[out] szFeatureId

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

[out] szComponentCode

GUID кода компонента. Этот буфер строк должен содержать 39 символов. Первые 38 символов предназначены для GUID, а последний — для завершающего символа 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.
Целевая платформа Windows
Header msi.h
Библиотека Msi.lib
DLL Msi.dll