인터넷 바로 가기
인터넷 바로 가기 개체는 인터넷 사이트에 대한 데스크톱 바로 가기를 만드는 데 사용됩니다. 파일 시스템의 항목 바로 가기와 마찬가지로 인터넷 바로 가기는 바탕 화면에서 아이콘의 형태를 취합니다. 사용자가 아이콘을 클릭하면 브라우저가 시작되고 바로 가기와 연결된 사이트가 표시됩니다.
다음 항목에 대해 설명합니다.
-
인터넷 바로 가기 만들기
- WebBrowser 컨트롤 인터넷 바로 가기 만들기
- URL 인터넷 바로 가기 만들기
- 속성 스토리지 액세스
- 인터페이스
- 함수
인터넷 바로 가기 만들기
WebBrowser 컨트롤을 사용하거나 페이지의 URL을 사용하여 인터넷 바로 가기를 만들 수 있습니다.
WebBrowser 컨트롤에서 인터넷 바로 가기 만들기
애플리케이션이 WebBrowser 컨트롤을 호스트하는 경우 인터넷 바로 가기 개체를 사용하여 다음과 같은 방법으로 바로 가기를 만들 수 있습니다.
- CLSID_InternetShortcut CLSID(클래스 식별자)를 사용하여 CoCreateInstance사용하여 인터넷 바로 가기 개체의 인스턴스를 만듭니다.
- IObjectWithSite::SetSite사용하여 WebBrowser의 IUnknown 인터페이스에 대한 포인터를 인터넷 바로 가기 개체에 전달합니다.
- WebBrowser 컨트롤에서 보는 페이지에 대한 바로 가기를 만들려면 인터넷 바로 가기 개체의 IPersistFile::Save 메서드를 호출합니다.
IPersistFile::Save지정한 위치에 바로 가기가 만들어집니다. 이 위치를 사용하면 WebBrowser 컨트롤이 해당 상태를 복원할 수 있습니다. 여기에는 올바른 문서를 프레임 세트로 로드하는 작업이 포함됩니다.
URL에서 인터넷 바로 가기 만들기
연결할 페이지의 URL이 있는 경우 인터넷 바로 가기를 만들 수도 있습니다.
- CLSID_InternetShortcut CLSID를 사용하여 CoCreateInstance사용하여 인터넷 바로 가기 개체의 인스턴스를 만듭니다.
- IUniformResourceLocator::SetURL 메서드를 사용하여 바로 가기에서 URL을 설정합니다.
- IPersistFile::Save 메서드를 사용하여 원하는 위치에 바로 가기 파일을 저장합니다.
속성 스토리지 액세스
인터넷 바로 가기 개체에는 다음 절차에 따라 개체의 IPropertySetStorage 인터페이스를 통해 액세스할 수 있는 몇 가지 속성이 포함되어 있습니다.
- IID_IPropertySetStorage QueryInterface 호출하여 IPropertySetStorage 인터페이스를 가져옵니다.
- FMTID_Intshcut 사용하여 IPropertySetStorage::Open 호출하여 인터넷 바로 가기 속성 스토리지 집합에 액세스하여 FMTID_InternetSite IPropertyStorage 인터페이스를 가져옵니다.
- 적절한 속성 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 인터페이스
- IDataObject
- IPersistFile
- IPersistStream
- IOleCommandTarget
- IPropertySetStorage
- IObjectWithSite
셸 인터페이스
함수
인터넷 바로 가기 개체와 함께 사용할 수 있는 몇 가지 유틸리티 함수가 있습니다.
인터넷 바로 가기 유틸리티 함수
- InetIsOffline
- MIMEAssociationDialog
- translateURL
- URLAssociationDialog