英語で読む

次の方法で共有

MsiGetShortcutTargetW 関数 (msi.h)

  • [アーティクル]

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 をエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント 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 Service Pack の詳細については、Windows インストーラーの Run-Time 要件を参照してください。
ターゲット プラットフォーム の ウィンドウズ
ヘッダー msi.h
ライブラリ Msi.lib
DLL Msi.dll