컨텍스트 문자열 키 바인딩
바인딩 컨텍스트를 지정하기 위해 IBindCtx::RegisterObjectParam 메서드와 함께 사용되는 문자열 키 집합입니다.
| 상수 | Description |
|---|---|
|
Windows XP SP2에 도입되었습니다. 데이터 원본의 클라이언트가 숨겨진 드라이브 문자 정책을 재정의하고 차단된 드라이브의 데이터 원본에 대한 뷰 개체에 액세스할 수 있도록 하려면 이 바인딩 컨텍스트를 지정합니다. IShellFolder::BindToObject 또는 IShellItem::BindToHandler와 함께 사용됩니다. 시스템은 사용자가 Windows Explorer 통해 해당 드라이브에 액세스하지 못하도록 차단하기 위해 지정된 드라이브 문자를 숨기는 관리자 제어 정책을 지원합니다. 이 정책이 활성화되면 정책에 의해 차단된 드라이브에서 호출될 때 IShellFolder::CreateViewObject 메서드를 사용하여 만든 뷰 개체 및 기타 처리기가 실패합니다. |
|
Windows Vista에 도입되었습니다.
IShellFolder::BindToObject 메서드가 pbc 매개 변수로 지정된 개체를 사용하여 대상 개체를 만들도록 하려면 이 바인딩 컨텍스트를 지정합니다. 이 경우 IBindCtx::RegisterObjectParam 호출에서 punk 매개 변수로 지정된 개체는 ICreateObject 인터페이스를 구현해야 합니다. IShellFolder::BindToObject 또는 IShellItem::BindToHandler와 함께 사용됩니다. |
|
Windows 7에 도입되었습니다. 구문 분석된 항목의 열거 모드를 제어하기 위해 FOLDER_ENUM_MODE 값을 사용하여 IShellFolder::P arseDisplayName에 전달됩니다.
FOLDER_ENUM_MODE 값은 IObjectWithFolderEnumMode를 구현하는 개체를 통해 바인딩 컨텍스트에 전달됩니다. 열거형 모드가 다른 항목은 서로 다른 항목 집합을 열거하기 때문에 SHCIDS_CANONICALONLY 서로 다른 방식으로 비교합니다. 항목이 열거형 모드를 지원하지 않는 경우(폴더가 아니거나 열거 모드를 제공하지 않기 때문에) 기본 열거형 모드로 만들어집니다. |
|
Windows 7에 도입되었습니다.
STR_FILE_SYS_BIND_DATA 함께 IShellFolder::P arseDisplayName에 전달됩니다. 이렇게 하면 간단한 구문 분석이 필요하지만 지역화된 이름 문자열을 가져올 경로를 따라 Desktop.ini 파일을 검색합니다. 이렇게 하면 경로를 따라 폴더를 검색하지 않습니다. 서버 또는 공유를 나타내는 폴더의 경우 광범위한 시간과 리소스가 걸릴 수 있습니다. Desktop.ini 파일은 일부 위치에 캐시되므로 폴더 특성을 검색한 다음 해당 폴더가 ou tot를 읽기 전용으로 설정해야 하는지 Desktop.ini 검색하는 것만큼 효율적입니다. |
|
Windows XP SP2에 도입되었습니다. 이 바인딩 컨텍스트를 지정하여 폴더 바로 가기가 대상을 가리키는 링크를 resolve 합니다. 폴더 바로 가기는 링크(바로 가기)를 사용하여 대상의 IDList를 보유하는 동일한 네임스페이스의 다른 폴더 항목을 가리키는 폴더 항목입니다. 링크가 이동되거나 이름이 바뀐 경우 대상을 추적하도록 확인됩니다. 예를 들어 Windows XP 내 네트워크 위치 폴더 및 Windows Vista 컴퓨터 폴더에는 네트워크 위치 추가 마법사를 사용하여 만든 폴더 바로 가기가 포함될 수 있습니다. 성능을 향상시키기 위해 IShellFolder::BindToObject 메서드는 기본적으로 네트워크 폴더에 대한 링크를 resolve 않습니다. IShellFolder::BindToObject 또는 IShellItem::BindToHandler와 함께 사용됩니다. |
|
Windows XP에 도입되었습니다. 데스크톱 폴더의 IShellFolder::P arseDisplayName 메서드 호출이 상대 경로를 데스크톱 을 기준으로 처리하지 않도록 하려면 이 바인딩 컨텍스트를 지정합니다. 이 경우 이 바인딩 컨텍스트가 지정되면 구문 분석이 실패합니다. |
|
Windows Vista에 도입되었습니다.
IShellItem::BindToHandler에서 BHID_LinkTargetItem GUID를 사용할 때 가져온 링크 대상을 resolve 않도록 IShellItem에 지시하려면 이 바인딩 컨텍스트를 지정합니다. |
|
Windows XP에 도입되었습니다. 실제 파일 메타데이터를 검색하는 대신 사용되는 IShellFolder::P arseDisplayName 메서드에 파일 메타데이터를 제공하려면 이 바인딩 컨텍스트를 지정합니다. 연결된 개체는 IFileSystemBindData 를 구현해야 하며 필요에 따라 IFileSystemBindData2를 구현할 수도 있습니다. 기본적으로 IShellFolder::P arseDisplayName 메서드는 파일이 있는지 확인하고 파일의 실제 메타데이터를 사용하여 ID 목록을 채웁니다. |
|
Windows 8.1 도입되었습니다. 이 바인딩 컨텍스트를 지정하여 STR_FILE_SYS_BIND_DATA 바인딩 컨텍스트에 제공된 데이터를 사용하여 Windows 7 형식의 ItemID 목록을 만들어야 합니다." |
|
Windows 7에 도입되었습니다. 처리기가 UI와 동일한 스레드에서 검색될 때 이 바인딩 컨텍스트를 지정합니다. 디스크 또는 네트워크 액세스와 관련된 작업과 같은 메모리 집약적인 작업은 피해야 합니다. |
|
Windows Vista에 도입되었습니다.
IPropertySetStorage 또는 IPropertyStore 처리기를 요청할 때 이 바인딩 컨텍스트를 지정합니다. 이 값은 IShellFolder::BindToObject와 함께 사용됩니다. 자세한 내용은 GPS_BESTEFFORT 플래그를 참조하세요. |
|
Windows Vista에 도입되었습니다.
IPropertySetStorage 또는 IPropertyStore 처리기를 요청할 때 이 바인딩 컨텍스트를 지정합니다. 이 값은 IShellFolder::BindToObject와 함께 사용됩니다. 자세한 내용은 GPS_DELAYCREATION 플래그를 참조하세요. |
|
Windows Vista에 도입되었습니다.
IPropertySetStorage 또는 IPropertyStore 처리기를 요청할 때 이 바인딩 컨텍스트를 지정합니다. 이 값은 IShellFolder::BindToObject와 함께 사용됩니다. 자세한 내용은 GPS_FASTPROPERTIESONLY 플래그를 참조하세요. |
|
Windows Vista에 도입되었습니다.
IPropertySetStorage 또는 IPropertyStore 처리기를 요청할 때 이 바인딩 컨텍스트를 지정합니다. 이 값은 IShellFolder::BindToObject와 함께 사용됩니다. 자세한 내용은 GPS_HANDLERPROPERTIESONLY 플래그를 참조하세요. |
|
Windows 7에 도입되었습니다.
IPropertySetStorage 또는 IPropertyStore 처리기를 요청할 때 이 바인딩 컨텍스트를 지정합니다. 이 값은 IShellFolder::BindToObject와 함께 사용됩니다. 자세한 내용은 GPS_NO_OPLOCK 플래그를 참조하세요. |
|
Windows Vista에 도입되었습니다.
IPropertySetStorage 또는 IPropertyStore 처리기를 요청할 때 이 바인딩 컨텍스트를 지정합니다. 이 값은 IShellFolder::BindToObject와 함께 사용됩니다. 자세한 내용은 GPS_OPENSLOWITEM 플래그를 참조하세요. |
|
Windows Vista에만 해당합니다. 다른 필터를 사용할 수 없는 경우 파일 시스템 개체에 대한 IFilter 인터페이스를 요청하여 텍스트 필터를 반환하도록 요청하는 IShellFolder::BindToObject 메서드를 호출하려면 이 바인딩 컨텍스트를 지정합니다. 이 값은 Windows 7로 정의되지 않습니다. |
|
Windows Vista에만 해당합니다. 등록된 필터를 찾을 수 없는 경우 대체 필터를 반환하지 않도록 파일 시스템 개체에 대한 IFilter 인터페이스를 요청하는 IShellFolder::BindToObject 메서드를 호출하려면 이 바인딩 컨텍스트를 지정합니다. |
|
Windows Vista에 도입되었습니다.
IPersistHistory::LoadHistory 메서드를 호출할 때 내부 탐색을 위해 스트림에서 기록을 로드할 수 있도록 이 바인딩 컨텍스트를 지정합니다. 내부 탐색은 동일한 보기 내의 탐색입니다. |
|
Windows 7에 도입되었습니다. 클라이언트가 해당 URL에 대해 DAV 형식 폴더를 만들 수 없는 경우 클라이언트가 유효한 URL에 대한 IDList를 생성하도록 Internet Shell 폴더 처리기를 원할 때 STR_PARSE_PREFER_FOLDER_BROWSING 이 바인딩 컨텍스트를 지정합니다. URL이 있는지 확인되지 않았습니다. 해당 구문만 검사되고 등록된 프로토콜 처리기가 있는지 확인합니다. |
|
Windows 7에 도입되었습니다. 이 바인딩 컨텍스트를 지정하여 IShellFolder::P arseDisplayName 및 IPersistFolder3::InitializeEx 의 구현에 셸 항목을 만들 때마다 이러한 개체를 다시 만드는 대신 셸 항목의 인스턴스화에 존재할 수 있는 메모리 집약적 도우미 개체를 캐시하도록 지시합니다. 연결된 개체는 처음에는 비어 있는 다른 바인딩 컨텍스트 개체입니다. 이로 인해 IBindCtx::GetObjectParam 또는 IBindCtx::Register.ObjectParam을 통해 액세스되는 별도의 바인딩 컨텍스트 개체가 생성됩니다. 호출자는 SHCreateItemFromParsingName을 호출할 때 이 바인딩 컨텍스트 매개 변수를 제공하여 이 동작을 옵트인해야 합니다. 이렇게 하면 여러 구문 분석 이름에 대한 바인딩 동작을 연속적으로 최적화합니다. 바인딩 컨텍스트 개체의 수명은 셸 항목의 여러 인스턴스와 개별 바인딩 컨텍스트에 걸쳐 있어야 합니다. |
|
Windows Vista에 도입되었습니다. 잘못된 파일 이름 문자가 파일 이름에 표시되도록 하려면 이 바인딩 컨텍스트를 지정합니다. 기본적으로 IShellFolder::P arseDisplayName 메서드를 호출하면 파일 이름에 잘못된 문자가 거부됩니다. 이 바인딩 컨텍스트는 STR_FILE_SYS_BIND_DATA 바인딩 컨텍스트와 함께만 의미가 있습니다. |
|
Windows Vista에 도입되었습니다.
데스크톱 폴더에서 IShellFolder::P arseDisplayName 메서드를 호출하여 URL을 구문 분석할 수 있도록 이 바인딩 컨텍스트를 지정합니다. 이 바인딩 컨텍스트를 지정하면 STR_PARSE_PREFER_WEB_BROWSING 재정의됩니다. |
|
Windows 7에 도입되었습니다. 이 바인딩 컨텍스트를 지정하여 데이터 원본의 IShellFolder::P arseDisplayName 구현에 SHCreateItemFromParsingName의 동작을 최적화하도록 지시합니다. 일반적으로 SHCreateItemFromParsingName 은 구문 분석할 이름에 대해 각각 하나씩, IShellFolder::P arseDisplayName 에 하나씩, 다른 하나는 셸 항목을 만드는 두 개의 바인딩 작업을 수행합니다. STR_PARSE_AND_CREATE_ITEM 바인딩 컨텍스트가 지원되면 IShellFolder::P arseDisplayName 바인딩 중에 셸 항목을 만들고 IParseAndCreateItem::SetItem을 통해 셸 항목을 저장하여 두 번째 바인딩을 방지합니다. SHCreateItemFromParsingName 은 저장된 셸 항목을 만드는 대신 사용합니다. 이 매개 변수는 구문 분석되는 이름의 마지막 요소에 적용됩니다. instance 경우 이름 "C:\Folder1\File.txt 데이터가 File.txt 적용됩니다. |
|
Windows Vista에만 해당합니다. URL을 구문 분석할 때 IDList를 생성하기 전에 이 바인딩 컨텍스트에 URL이 필요하지 않도록 지정합니다. 지정된 URL에 대해 DAV 폴더를 만들 수 없는 경우 클라이언트가 Internet Shell 폴더 처리기에서 URL에 대한 IDList를 생성하려는 경우 STR_PARSE_PREFER_FOLDER_BROWSING 함께 이 바인딩 컨텍스트를 지정합니다. |
|
Windows Vista에 도입되었습니다. 이 바인딩 컨텍스트를 지정하여 해당 항목이 IParentAndItem 인터페이스를 구현하는 IShellItem 개체로 저장될 때 다시 구문 분석되는 원래 항목을 전달합니다. Windows 7 이전에는 이 값이 헤더 파일에 정의되지 않았습니다. 호출자가 정의하거나 L"ParseOriginalItem"의 문자열 값으로 전달할 수 있습니다. Windows 7을 기준으로 값은 Shlobj.h에 정의됩니다. 다른 STR 상수와는 다른 헤더입니다. |
|
Windows XP에 도입되었습니다.
데스크톱 폴더에서 IShellFolder::P arseDisplayName 메서드를 호출하여 URL을 폴더인 것처럼 구문 분석하려면 이 바인딩 컨텍스트를 지정합니다. 이 바인딩 컨텍스트를 사용하여 WebDAV 서버에 바인딩합니다. |
|
Windows Vista에 도입되었습니다.
데스크톱 폴더 양식 구문 분석 URL에서 IShellFolder::P arseDisplayName 메서드에 대한 호출을 방지하려면 이 바인딩 컨텍스트를 지정합니다. 이 바인딩 컨텍스트는 STR_PARSE_ALLOW_INTERNET_SHELL_FOLDERS 재정의할 수 있습니다. |
|
Windows Vista에 도입되었습니다. 이 바인딩 컨텍스트를 지정하여 IShellFolder::P arseDisplayName 메서드에서 사용하는 기본 속성 저장소를 재정의하고 대신 bind 매개 변수로 지정된 속성 저장소를 사용합니다. 대리자 폴더에 적용됩니다. |
|
Windows XP SP2에 도입되었습니다.
바탕 화면 폴더에서 IShellFolder::P arseDisplayName 메서드를 호출하여 "shell:" 접두사 표기법을 사용하여 파일에 액세스할 수 있도록 이 바인딩 컨텍스트를 지정합니다. |
|
Windows Vista에 도입되었습니다. 네트워크 경로 구문 분석이 실패할 경우 IShellFolder::P arseDisplayName 메서드를 호출하여 네트워크 진단 대화 상자를 표시하도록 이 바인딩 컨텍스트를 지정합니다. |
|
Windows Vista에 도입되었습니다.
IShellFolder::P arseDisplayName 메서드를 호출하여 네트워크 공유 캐시 확인을 건너뛰고 네트워크 서버에 직접 연결하도록 이 바인딩 컨텍스트를 지정합니다. 네트워크 공유에 대한 정보는 성능을 향상시키기 위해 캐시되며 IShellFolder::P arseDisplayName 은 기본적으로 이 캐시를 확인합니다. |
|
Windows XP에 도입되었습니다. 대리자 네임스페이스에 대해 구문 분석된 속성을 IShellFolder::P arseDisplayName 메서드에 전달하려면 이 바인딩 컨텍스트를 지정합니다. 네임스페이스는 이름 자체를 구문 분석하는 대신 전달된 속성을 사용할 수 있습니다. |
|
Windows Vista에만 해당합니다.
IShellFolder::P arseDisplayName을 호출할 때 속성 집합과 항목의 이름을 전달하는 데 사용되는 구문 분석 바인딩 컨텍스트입니다. 바인딩 컨텍스트의 개체는 IPropertyStore 를 구현하고 IBindCtx::GetObjectParam을 호출하여 검색됩니다. DBFolder는 검색 결과 및 쿼리 기반 뷰의 항목을 나타내는 셸 데이터 원본입니다. DBFolder는 Windows Search 시스템을 쿼리하여 이러한 항목을 검색합니다. 검색 결과의 항목은 프로토콜 체계(예: "file:" 또는 "mapi:")를 통해 식별됩니다. DBFolder는 이러한 프로토콜에 대해 생성된 셸 데이터 원본을 위임하여 이러한 항목에 대한 동작을 제공합니다. 자세한 내용은 프로토콜 처리기 추가 기능 개발을 참조하세요. DBFolder가 Windows Search 프로토콜을 지원하는 셸 데이터 원본에 구문 분석 작업을 위임하는 경우 이 바인딩 컨텍스트는 해당 항목에 대한 쿼리 결과에 반환된 값에 대한 액세스를 제공합니다. 여기에는 다음이 포함됩니다.
클라이언트에 항목을 정의하는 속성 집합이 있는 경우 이 바인딩 컨텍스트를 사용하여 DBFolder 항목을 구문 분석할 수도 있습니다. 이 경우 빈 이름을 IShellFolder::P arseDisplayName에 전달해야 합니다. Windows 7 이전에는 이 값이 헤더 파일에 정의되지 않았습니다. 호출자가 정의하거나 문자열 값() L"ParseWithProperties"으로 전달할 수 있습니다. Windows 7을 기준으로 값은 Shlobj.h에 정의됩니다. 다른 STR 상수가 정의된 위치와는 다른 헤더입니다. |
|
Windows 8에 도입되었습니다. 바인딩 컨텍스트 매개 변수가 바인딩 컨텍스트에서 VARIANT 값을 전달하는 데 사용되는 속성 모음(IPropertyBag)임을 나타내려면 이 바인딩 컨텍스트를 지정합니다. 자세한 내용은 설명 섹션을 참조하세요. |
|
STR_SKIP_BINDING_CLSID |
Windows XP에 도입되었습니다. 구문 분석 또는 바인딩 시 IShellFolder::P arseDisplayName 또는 IShellFolder::BindToObject 메서드를 호출하여 특정 셸 네임스페이스 확장을 무시하도록 이 바인딩 컨텍스트를 지정합니다. 무시할 네임스페이스의 CLSID는 bind 매개 변수의 IPersist::GetClassID 메서드에서 제공됩니다. 참고: Windows 2000 SP3에서 도입된 이 값은 Shobjidl.h로 이동되었을 때 Windows XP까지 Shlobj.h에 정의되었습니다. |
|
사용되지 않습니다. |
설명
바인딩 컨텍스트는 IBindCtx* 매개 변수가 있는 함수에 선택적 매개 변수를 전달하는 데 사용됩니다. 이러한 매개 변수는 COM 개체로 표현되며 매개 변수 데이터를 모델링하는 데 사용되는 인터페이스를 구현할 수 있습니다. 일부 바인딩 컨텍스트는 부울 값을 나타냅니다. 여기서 TRUE 는 IUnknown 만 구현하는 개체를 나타내고 FALSE는 개체가 없음을 나타냅니다.
IShellFolder::P arseDisplayName, IShellFolder::BindToObject 및 IShellItem::BindToHandler 는 바인딩 컨텍스트를 사용하고 해당 바인딩 컨텍스트를 통해 매개 변수를 전달할 수 있습니다.
일부 바인딩 컨텍스트는 특정 데이터 원본 구현 또는 처리기 형식과 관련이 있습니다.
바인딩 컨텍스트 매개 변수는 특정 함수 또는 메서드와 함께 사용하도록 정의됩니다.
IShellFolder를 통해 속성 저장소를 요청할 때 null IBindCtx 매개 변수를 전달하여 해당 GPS_DEFAULT 지정할 수 있습니다. STGM_READWRITE 모드를 전달하여 GPS_READWRITE 해당하는 를 지정할 수도 있습니다. 바인딩 컨텍스트에서 STGM_EXCLUSIVE.
STR_PROPERTYBAG_PARAM 바인딩 컨텍스트 개체로 지정된 속성 모음에는 IPropertyBag::Read 및 IPropertyBag::Write 메서드를 사용하여 액세스할 수 있는 추가 값이 포함되어 있습니다.
| 속성 이름 | Type | Description |
|---|---|---|
| STR_ENUM_ITEMS_FLAGS | VT_UI4 | Windows 8에 도입되었습니다. BHID_EnumItems 사용하여 IShellItem::BindToHandler를 호출할 때 IShellFolder::EnumObjects에 전달할 SHCONTF 값을 지정합니다. |
| STR_PARSE_EXPLICIT_ASSOCIATION_SUCCESSFUL | VT_BOOL | Windows 7에 도입되었습니다. IShellFolder::P arseDisplayName 메서드는 반환된 IDList가 STR_PARSE_WITH_EXPLICIT_PROGID 지정된 ProgID 또는 STR_PARSE_WITH_EXPLICIT_ASSOCAPP 지정된 애플리케이션에 바인딩되었음을 호출자에게 알리도록 이 속성을 설정합니다. STR_PARSE_EXPLICIT_ASSOCIATION_SUCCESSFUL 없는 경우 ProgID 또는 애플리케이션이 IDList에 바인딩되지 않았습니다. |
| STR_PARSE_WITH_EXPLICIT_ASSOCAPP | VT_BSTR | Windows 7에 도입되었습니다. IShellFolder::P arseDisplayName 메서드를 호출하여 애플리케이션의 파일 형식 연결 처리기에 바인딩된 IDList를 반환하도록 이 속성을 지정합니다. |
| STR_PARSE_WITH_EXPLICIT_PROGID | VT_BSTR | Windows 7에 도입되었습니다. IShellFolder::P arseDisplayName 메서드를 호출하여 제공된 ProgID의 파일 연결 처리기에 바인딩된 IDList를 반환하도록 이 속성을 지정합니다. |
바인딩 컨텍스트 값을 사용하는 예제는 매개 변수를 사용한 구문 분석 샘플을 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 |
Windows Server 2008 R2 [데스크톱 앱만 해당] |
| 헤더 |
|
| IDL |
|