IApplicationAssociationRegistration::QueryCurrentDefault 메서드(shobjidl_core.h)

지정된 연결 형식에 대한 기본 애플리케이션을 결정합니다. 이 애플리케이션은 해당 형식에 대해 ShellExecute 에서 시작된 기본 애플리케이션입니다.

구문

HRESULT QueryCurrentDefault(
  [in]  LPCWSTR          pszQuery,
  [in]  ASSOCIATIONTYPE  atQueryType,
  [in]  ASSOCIATIONLEVEL alQueryLevel,
  [out] LPWSTR           *ppszAssociation
);

매개 변수

[in] pszQuery

형식: LPCWSTR

파일 이름 확장명 또는 프로토콜(예: .mp3 또는 http)이 포함된 null로 끝나는 유니코드 문자열에 대한 포인터입니다.

[in] atQueryType

형식: ASSOCIATIONTYPE

연결 형식(예: 확장 또는 MIME 형식)을 지정하는 ASSOCIATIONTYPE 열거형 값 중 하나입니다.

[in] alQueryLevel

형식: ASSOCIATIONLEVEL

사용자 또는 컴퓨터와 같은 연결 수준을 지정하는 ASSOCIATIONLEVEL 열거형 값 중 하나입니다. 이는 일반적으로 AL_EFFECTIVE.

[out] ppszAssociation

형식: LPWSTR*

이 메서드가 반환되면 현재 기본 연결을 식별하는 ProgID에 대한 포인터의 주소가 포함됩니다.

참고CoTaskMemFree를 통해 문자열을 해제하는 것은 호출 애플리케이션의 책임입니다.

 

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

생성된 문자열은 일반적으로 등록된 애플리케이션과 연결된 ProgID 중 하나와 일치하는 ProgID이지만 몇 가지 예외가 있습니다. 반환된 문자열이 컴퓨터 기본 프로토콜인 경우 ProgID 대신 .exe 처리기에 대한 명령줄을 나타내는 레거시 문자열입니다. 마찬가지로 머신 기본 MIME 형식을 반환하는 경우 ProgID 대신 CLSID(레거시 클래스 식별자) 문자열을 반환합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	shobjidl_core.h(Shobjidl.h 포함)

추가 정보

기본 프로그램

IApplicationAssociationRegistration