IShellLinkA::GetPath 메서드(shobjidl_core.h)

아티클
08/26/2023

Shell 링크 개체 대상의 경로 및 파일 이름을 가져옵니다.

구문

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

매개 변수

[out] pszFile

형식: LPTSTR

Shell 링크 개체 대상의 경로 및 파일 이름을 수신하는 버퍼의 주소입니다.

[in] cch

형식: int

종료 null 문자를 포함하여 pszFile 매개 변수가 가리키는 버퍼의 크기(문자)입니다. 반환할 수 있는 최대 경로 크기는 MAX_PATH. 이 매개 변수는 일반적으로 ARRAYSIZE(pszFile)를 호출하여 설정됩니다. ARRAYSIZE 매크로는 Winnt.h에 정의되어 있습니다.

[in, out] pfd

형식: WIN32_FIND_DATA*

Shell 링크 개체의 대상에 대한 정보를 수신하는 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 이상)

다음을 통해 공유