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 インターフェイスを介してアクセスできます。

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

注意

msi.h ヘッダーは、MSIGetShortcutTarget をエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

サポートされている最小のクライアント	Windows Server 2012、Windows 8、Windows Server 2008 R2、または Windows 7 の Windows インストーラー 5.0。 Windows Server 2008 または Windows Vista の Windows インストーラー 4.0 または Windows インストーラー 4.5。 Windows Server 2003 または Windows XP の Windows インストーラー。 Windows インストーラーのバージョン別に必須となる最小 Windows サービス パックに関する詳細については、Windows インストーラーの実行時の要件に関する記事を参照してください。
対象プラットフォーム	Windows
ヘッダー	msi.h
Library	Msi.lib
[DLL]	Msi.dll