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 文字用です。 このパラメーターには、null を指定できます。

[out] szFeatureId

ショートカットの機能名。 文字列バッファーの長さは、MAX_FEATURE_CHARS +1 文字にする必要があります。 このパラメーターには、null を指定できます。

[out] szComponentCode

コンポーネント コードの GUID。 この文字列バッファーの長さは 39 文字にする必要があります。 最初の 38 文字は GUID 用で、最後の文字は終端の null 文字用です。 このパラメーターには、null を指定できます。

戻り値

この関数は UINT を返します。

解説

関数が失敗し、ショートカットが存在する場合、ショートカットの通常の内容に IShellLink インターフェイスを介してアクセスできます。

それ以外の場合は、 インストーラー選択関数を使用してターゲットの状態を決定できます。

要件