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

아티클
03/02/2024

Shell 링크 개체의 상대 경로를 설정합니다.

구문

HRESULT SetRelativePath(
  LPCSTR pszPathRel,
  DWORD  dwReserved
);

매개 변수

pszPathRel

형식: LPCTSTR

바로 가기 확인을 수행해야 하는 상대 바로 가기 파일의 정규화된 경로를 포함하는 버퍼의 주소입니다. 폴더 이름이 아니라 파일 이름이어야 합니다.

dwReserved

형식:DWORD

예약되어 있습니다. 이 매개 변수를 0으로 설정합니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

클라이언트는 일반적으로 대상과 함께 이동할 수 있는 상대 링크를 정의하므로 절대 경로가 유효하지 않습니다. SetRelativePath 메서드를 사용하면 링크 확인 프로세스가 대상과 상대 경로 사이의 공통 경로 접두사를 기반으로 대상을 찾을 수 있습니다. 확인 프로세스를 지원하기 위해 클라이언트는 링크 만들기 프로세스의 일부로 상대 경로를 설정해야 합니다.

예제

다음 시나리오를 고려하세요.

c:\MyLink.lnk 링크가 있습니다.
링크 대상이 c:\MyDocs\MyFile.txt.
링크를 이동하고 d:\로 MyDocs\MyFile.txt.

바로 가기를 저장하기 전에 상대 경로를 사용하여 원래 링크를 만들어 해결 프로세스를 지원할 수 있습니다.

::SetRelativePath("c:\MyLink.lnk", NULL);

바로 가기를 확인하기 전에 새 상대 경로를 설정하고 해결 코드는 새 위치에서 파일을 찾습니다.

::SetRelativePath("d:\MyLink.lnk", NULL);

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	shobjidl_core.h
DLL	Shell32.dll(버전 4.0 이상)