다음을 통해 공유


Internet Shortcuts

인터넷 바로 가기 개체는 인터넷 사이트에 대한 데스크톱 바로 가기를 만드는 데 사용됩니다. 파일 시스템의 항목 바로 가기와 마찬가지로 인터넷 바로 가기는 바탕 화면에서 아이콘의 형태를 취합니다. 사용자가 아이콘을 클릭하면 URL 경로는 일반적으로 사용자의 기본 웹 브라우저인 처리기 애플리케이션에서 열립니다.

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

인터넷 바로 가기 만들기

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 Variant Type Description
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 Author
PID_IS_DESCRIPTION VT_LPWSTR 사이트의 설명 텍스트
PID_IS_COMMENT VT_LPWSTR 사용자 주석 달기 메모
PID_IS_ROAMED VT_BOOL 바로 가기가 처음으로 로밍되는 경우 True입니다.

 

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

PROPID Variant Type Description
PID_INTSITE_WHATSNEW VT_LPWSTR 새로운 기능 텍스트
PID_INTSITE_AUTHOR VT_LPWSTR Author
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 Title
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 로밍으로 인해 항목이 추가되었습니다.

 

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

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

 

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

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

 

Interfaces

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

OLE interfaces

Shell interfaces

Functions

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

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