IQueryAssociations 인터페이스(shlwapi.h)

파일 형식 또는 프로토콜을 정의하고 애플리케이션과 연결하여 레지스트리에 저장된 정보를 검색하는 프로세스를 간소화하는 메서드를 노출합니다.

상속

IQueryAssociations 인터페이스는IUnknown 인터페이스에서 상속됩니다. IQueryAssociations 에는 다음과 같은 유형의 멤버도 있습니다.

메서드

IQueryAssociations 인터페이스에는 이러한 메서드가 있습니다.

IQueryAssociations::GetData 레지스트리에서 파일 또는 프로토콜 연결 관련 이진 데이터를 검색하고 검색합니다.
IQueryAssociations::GetEnum 이 메서드가 구현되지 않은 경우 (IQueryAssociations.GetEnum)
IQueryAssociations::GetKey 레지스트리에서 파일 또는 프로토콜 연결 관련 키를 검색하고 검색합니다.
IQueryAssociations::GetString 레지스트리에서 파일 또는 프로토콜 연결 관련 문자열을 검색하고 검색합니다. (IQueryAssociations.GetString)
IQueryAssociations::Init IQueryAssociations 인터페이스를 초기화하고 루트 키를 적절한 ProgID로 설정합니다.

설명

구현 시기

이 인터페이스는 파일 및 프로토콜 연결 처리를 간소화하기 위해 셸 또는 네임스페이스 확장에 의해 노출됩니다. 이 인터페이스를 구현하면 안 됩니다.

사용해야 하는 경우

파일 또는 프로토콜 연결과 관련된 레지스트리의 정보가 필요한 경우 이 인터페이스를 사용합니다. 예를 들어 이 인터페이스를 사용하여 동사 중 하나의 명령 문자열과 같은 파일 이름 확장명과 관련된 정보를 검색할 수 있습니다.

전체 레지스트리 경로 또는 HKEY 값은 필요하지 않습니다. 대신 파일 이름 확장명 또는 실행 파일 이름과 같은 조건에 따라 정보를 검색할 수 있습니다. 파일 연결에 대한 자세한 내용은 파일 형식을 참조하세요.

이 인터페이스를 사용하여 애플리케이션의 이름을 검색할 수도 있습니다. 메서드 IQueryAssociations::GetString을 사용합니다. str 매개 변수를 ASSOCSTR_FRIENDLYAPPNAME 설정합니다.

이 인터페이스를 사용하려면 먼저 포인터를 검색해야 합니다. 일반적으로 Shell 개체의 IShellFolder::GetUIObjectOf 메서드를 호출하여 QueryInterface 포인터를 검색합니다. AssocCreate를 호출하여 인터페이스 포인터를 검색할 수도 있습니다(clsid를 CLSID_QueryAssociations 설정). IQueryAssociations::Init를 사용하여 인터페이스를 초기화합니다. 이 메서드는 레지스트리에서 정보를 검색하기 위해 나머지 세 가지 메서드를 호출할 때 사용할 루트 키를 설정합니다. 루트 키 아래에만 표시됩니다. 더 이상 필요하지 않은 경우 인터페이스를 해제해야 합니다.

IQueryAssociations 인터페이스는 레지스트리에서 정보를 반복적으로 쿼리해야 하는 경우에 유용합니다. 인터페이스가 초기화되면 다양한 메서드를 호출하는 오버헤드가 상대적으로 작습니다. 또한 참조 섹션에 나열된 여러 관련 함수가 있습니다. 이를 통해 단일 함수 호출을 사용하여 레지스트리에서 동일한 정보를 검색할 수 있습니다. 사용하기가 더 간단하지만 호출될 때마다 IQueryAssociations 를 만들고 초기화하는 오버헤드가 발생합니다. 이 때문에 단일 사용에 가장 적합합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional, Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	shlwapi.h

추가 정보

AssocQueryKey

AssocQueryString

AssocQueryStringByKey