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

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

構文

HRESULT GetPath(
  [out]     LPSTR            pszFile,
  [in]      int              cch,
  [in, out] WIN32_FIND_DATAA *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

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

SLGP_UNCPRIORITY

サポート;は使用しないでください。

SLGP_RAWPATH

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

SLGP_RELATIVEPRIORITY

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

戻り値

型: HRESULT

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

要件