IShellLink

IShellLink::GetPath

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

HRESULT STDMETHODCALLTYPE GetPath(
    LPTSTR           pszFile,
    int              cchMaxPath,
    WIN32_FIND_DATA *pfd,
    DWORD            fFlags
);

メソッドのインデックス: 3

パラメータ

pszFile

シェルリンクオブジェクトのパスおよびファイル名を格納するバッファのアドレスを指定します。

cchMaxPath

pszFile パラメータで表されるバッファのサイズを指定します。

pfd

シェルリンクオブジェクトの情報を格納する WIN32_FIND_DATA 構造体のアドレスを指定します。このパラメータに 0 (NULL) を指定すると、追加情報は取得されません。

fFlags

受け取るパスのタイプを指定します。0 または以下の値の組み合わせで指定します。

意味
0x0001 (SLGP_SHORTPATH)

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

0x0002 (SLGP_UNCPRIORITY)

UNCパス名を取得します。

0x0004 (SLGP_RAWPATH)

変換されていないパス名を取得します。環境変数が指定されている場合に、変換されない形で取得されます。

戻り値

関数が成功して有効なパスが取得されると 0 (NOERROR) が返ります。

関数が成功しているがパスが取得されない場合は 1 (S_FALSE) が返ります。このとき、 pszFile パラメータが指すバッファは空文字列になります。

失敗すると OLE 定義のエラー値が返ります。

対応情報

Shell32.dll Version 4.00 以降

Windows 95 以降 / Windows NT 4.0 以降