다음을 통해 공유


인터넷 바로 가기

인터넷 바로 가기 개체는 인터넷 사이트에 대한 데스크톱 바로 가기를 만드는 데 사용됩니다. 파일 시스템의 항목 바로 가기와 마찬가지로 인터넷 바로 가기는 바탕 화면에서 아이콘의 형태를 취합니다. 사용자가 아이콘을 클릭하면 브라우저가 시작되고 바로 가기와 연결된 사이트가 표시됩니다.

다음 항목에 대해 설명합니다.

인터넷 바로 가기 만들기

WebBrowser 컨트롤을 사용하거나 페이지의 URL을 사용하여 인터넷 바로 가기를 만들 수 있습니다.

WebBrowser 컨트롤에서 인터넷 바로 가기 만들기

애플리케이션이 WebBrowser 컨트롤을 호스트하는 경우 인터넷 바로 가기 개체를 사용하여 다음과 같은 방법으로 바로 가기를 만들 수 있습니다.

  1. CLSID_InternetShortcut CLSID(클래스 식별자)를 사용하여 CoCreateInstance사용하여 인터넷 바로 가기 개체의 인스턴스를 만듭니다.
  2. IObjectWithSite::SetSite사용하여 WebBrowser의 IUnknown 인터페이스에 대한 포인터를 인터넷 바로 가기 개체에 전달합니다.
  3. WebBrowser 컨트롤에서 보는 페이지에 대한 바로 가기를 만들려면 인터넷 바로 가기 개체의 IPersistFile::Save 메서드를 호출합니다.

IPersistFile::Save지정한 위치에 바로 가기가 만들어집니다. 이 위치를 사용하면 WebBrowser 컨트롤이 해당 상태를 복원할 수 있습니다. 여기에는 올바른 문서를 프레임 세트로 로드하는 작업이 포함됩니다.

URL에서 인터넷 바로 가기 만들기

연결할 페이지의 URL이 있는 경우 인터넷 바로 가기를 만들 수도 있습니다.

  1. CLSID_InternetShortcut CLSID를 사용하여 CoCreateInstance사용하여 인터넷 바로 가기 개체의 인스턴스를 만듭니다.
  2. IUniformResourceLocator::SetURL 메서드를 사용하여 바로 가기에서 URL을 설정합니다.
  3. IPersistFile::Save 메서드를 사용하여 원하는 위치에 바로 가기 파일을 저장합니다.

속성 스토리지 액세스

인터넷 바로 가기 개체에는 다음 절차에 따라 개체의 IPropertySetStorage 인터페이스를 통해 액세스할 수 있는 몇 가지 속성이 포함되어 있습니다.

  1. IID_IPropertySetStorage QueryInterface 호출하여 IPropertySetStorage 인터페이스를 가져옵니다.
  2. FMTID_Intshcut 사용하여 IPropertySetStorage::Open 호출하여 인터넷 바로 가기 속성 스토리지 집합에 액세스하여 FMTID_InternetSite IPropertyStorage 인터페이스를 가져옵니다.
  3. 적절한 속성 ID를 전달하여 IPropertyStorage::ReadMultiple 사용하여 속성 스토리지 정보를 읽습니다.

버전 4.70 이상의 Shell32.dll 사용하면 pidl 매개 변수가 설정된 IShellFolder::BindToStorage 호출하여 IPropertySetStorage 인터페이스를 검색할 수도 있습니다. URL 파일 및 riid 매개 변수가 IID_IPropertySetStorage 설정됩니다.

FMTID_Intshcut 다음 속성 ID를 요청할 수 있습니다.

PROPID 변형 형식 묘사
PID_IS_URL VT_LPWSTR 바로 가기가 연결되는 URL
PID_IS_NAME VT_LPWSTR 인터넷 바로 가기의 이름
PID_IS_WORKINGDIR VT_LPWSTR 바로 가기에 대한 작업 디렉터리
PID_IS_HOTKEY VT_UI2 바로 가기 키
PID_IS_SHOWCMD VT_I4 바로 가기에 대한 명령 표시
PID_IS_ICONINDEX VT_I4 아이콘의 인덱스
PID_IS_ICONFILE VT_LPWSTR 아이콘이 포함된 파일
PID_IS_WHATSNEW VT_LPWSTR 새로운 기능 텍스트
PID_IS_AUTHOR VT_LPWSTR 저자
PID_IS_DESCRIPTION VT_LPWSTR 사이트의 설명 텍스트
PID_IS_COMMENT VT_LPWSTR 사용자 주석 달기 메모
PID_IS_ROAMED VT_BOOL 바로 가기가 처음으로 로밍되는 경우 True입니다.

 

FMTID_InternetSite 다음 속성 ID를 요청할 수 있습니다.

PROPID 변형 형식 묘사
PID_INTSITE_WHATSNEW VT_LPWSTR 새로운 기능 텍스트
PID_INTSITE_AUTHOR VT_LPWSTR 저자
PID_INTSITE_LASTVISIT VT_FILETIME 마지막으로 방문한 시간 사이트
PID_INTSITE_LASTMOD VT_FILETIME 마지막으로 수정된 시간 사이트
PID_INTSITE_VISITCOUNT VT_UI4 사용자가 방문한 횟수
PID_INTSITE_DESCRIPTION VT_LPWSTR 사이트의 설명 텍스트
PID_INTSITE_COMMENT VT_LPWSTR 사용자 주석 달기 메모
PID_INTSITE_FLAGS VT_UI4 PIDISF_ 플래그 사용을 나타냅니다(아래 참조).
PID_INTSITE_CONTENTLEN 해당(N/A) 현재 지원되지 않음
PID_INTSITE_CONTENTCODE 해당(N/A) 현재 지원되지 않음
PID_INTSITE_RECURSE 해당(N/A) 현재 지원되지 않음
PID_INTSITE_WATCH 해당(N/A) 현재 지원되지 않음
PID_INTSITE_SUBSCRIPTION VT_UI8 구독 관리자에 대한 SUBSCRIPTIONCOOKIE 값
PID_INTSITE_URL VT_LPWSTR 바로 가기가 연결되는 URL
PID_INTSITE_TITLE VT_LPWSTR 타이틀
PID_INTSITE_CODEPAGE VT_UI4 문서의 코드 페이지
PID_INTSITE_TRACKING 해당(N/A) 현재 지원되지 않음
PID_INTSITE_ICONINDEX VT_I4 아이콘의 인덱스
PID_INTSITE_ICONFILE VT_LPWSTR 아이콘이 포함된 파일
PID_INTSITE_ROAMED VT_UI4 로밍으로 인해 항목이 추가되었습니다.

 

다음은 인터넷 사이트 플래그입니다.

묘사
PIDISF_RECENTLYCHANGED 사이트가 최근에 변경되었음을 나타냅니다.
PIDISF_CACHEDSTICKY 현재 지원되지 않음
PIDISF_CACHEIMAGES 현재 지원되지 않음
PIDISF_FOLLOWALLLINKS 현재 지원되지 않음

 

다음 값은 인터넷 로밍 기록에 사용됩니다.

PID_INTSITE_ROAMED 값 묘사
값이 설정되지 않았거나 PIDISR_UP_TO_DATE 이 캐시 항목은 로밍에 의해 수정되지 않았습니다.
PIDISR_NEEDS_ADD 이 캐시 항목은 로밍하여 캐시에 추가되었습니다. 항목 처리가 완료되면 PIDISR_UP_TO_DATE 설정합니다.
PIDISR_NEEDS_UPDATE 이 캐시 항목은 이미 로컬 컴퓨터에 있지만 로밍을 통해 업데이트되었습니다. 항목 처리가 완료되면 PIDISR_UP_TO_DATE 설정합니다.
PIDISR_NEEDS_DELETE 로밍에서 이 캐시 항목을 삭제해야 한다는 것을 발견했습니다. 예를 들어 사용자가 브라우저 기록을 지울 수 있습니다. DeleteUrlCacheEntry를 사용하여 항목을 삭제합니다.

 

인터페이스

인터넷 바로 가기 개체는 여러 인터페이스를 노출합니다.

OLE 인터페이스

셸 인터페이스

  • IContextMenu2
  • IExtractIcon
  • INewShortcutHook
  • IShellExtInit
  • IShellLink
  • IShellPropSheetExt
  • IQueryInfo

함수

인터넷 바로 가기 개체와 함께 사용할 수 있는 몇 가지 유틸리티 함수가 있습니다.

인터넷 바로 가기 유틸리티 함수