IShellLinkW::GetPath メソッド (shobjidl_core.h)

[アーティクル]
03/02/2024

シェルリンクオブジェクトのターゲットのパスとファイル名を取得します。

構文

HRESULT GetPath(
  [out]     LPWSTR           pszFile,
  [in]      int              cch,
  [in, out] WIN32_FIND_DATAW *pfd,
  [in]      DWORD            fFlags
);

パラメーター

[out] pszFile

種類: LPTSTR

シェルリンクオブジェクトのターゲットのパスとファイル名を受け取るバッファーのアドレス。

[in] cch

型: int

pszFile パラメーターが指すバッファーのサイズ (文字単位) (終端の null 文字を含む)。返すことができる最大パスサイズはMAX_PATH。このパラメーターは、通常、ARRAYSIZE(pszFile) を呼び出すことによって設定されます。 ARRAYSIZE マクロは Winnt.h で定義されています。

[in, out] pfd

種類: WIN32_FIND_DATA*

シェルリンクオブジェクトのターゲットに関する情報を受け取るWIN32_FIND_DATA構造体へのポインター。このパラメーターが NULL の場合、追加情報は返されません。

[in] fFlags

型: DWORD

取得するパス情報の種類を指定するフラグ。このパラメーターは、次の値と組み合わせて使用できます。

SLGP_SHORTPATH

標準の短い (8.3 形式) ファイル名を取得します。

SLGP_UNCPRIORITY

サポート;は使用しません。

SLGP_RAWPATH

生パス名を取得します。生パスは存在しない可能性があり、展開する必要がある環境変数を含む場合があります。

SLGP_RELATIVEPRIORITY

Windows Vista 以降。 IShellLink::SetRelativePath の以前の呼び出しによって設定されたパスに対するショートカットのターゲットのパス (可能な場合) を取得します。

戻り値

種類: HRESULT

操作が成功し、有効なパスが取得された場合は、 S_OK を返します。操作が成功してもパスが取得されない場合は、 S_FALSE が返され、 pszFile は空になります。それ以外の場合は、標準の HRESULT エラー値のいずれかを返します。

要件

要件	値
サポートされている最小のクライアント	Windows XP (デスクトップアプリのみ)
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	shobjidl_core.h
[DLL]	Shell32.dll (バージョン 4.0 以降)

次の方法で共有