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 エラー値のいずれかを返します。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | shobjidl_core.h |
[DLL] | Shell32.dll (バージョン 4.0 以降) |