다음을 통해 공유

IQueryAssociations::Init 메서드(shlwapi.h)

  • 아티클

IQueryAssociations 인터페이스를 초기화하고 루트 키를 적절한 ProgID로 설정합니다.

구문

HRESULT Init(
  [in]           ASSOCF  flags,
  [in, optional] LPCWSTR pszAssoc,
  [in, optional] HKEY    hkProgid,
  [in, optional] HWND    hwnd
);

매개 변수

[in] flags

형식: ASSOCF

검색을 초기화하는 방법을 지정하는 플래그입니다. 일반적으로 0으로 설정되지만 다음 ASSOCF 값 중 하나를 사용할 수도 있습니다.

[in, optional] pszAssoc

형식: LPCWSTR

루트 키를 확인하는 데 사용되는 유니코드 문자열입니다. 값이 hkProgid에 지정된 경우 이 매개 변수를 NULL로 설정합니다. 다음 네 가지 유형의 문자열을 사용할 수 있습니다.

파일 이름 확장명

파일 이름 확장명(예: .txt)

CLSID

표준 "{GUID}" 형식의 CLSID GUID입니다.

ProgID

애플리케이션의 ProgID(예: Word) Document.8.

실행 파일 이름

애플리케이션의 .exe 파일의 이름입니다. ASSOCF_OPEN_BYEXENAME 플래그는 플래그로 설정해야 합니다.

[in, optional] hkProgid

형식: HKEY

루트 키로 사용되는 하위 키의 HKEY 값입니다. 검색은 이 키 아래에만 표시됩니다. pwszAssoc에 값을 지정한 경우 이 매개 변수를 NULL로 설정합니다.

[in, optional] hwnd

형식: HWND

반환 값

형식: HRESULT

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

설명

이 메서드는 인터페이스를 초기화하고 새 루트 키를 지정해야 할 때마다 호출됩니다. pwszAssoc을 사용하여 루트 키를 식별하는 파일 이름 확장명 또는 연결된 ProgID와 같은 문자열을 지정할 수 있습니다. 루트 키의 HKEY 값을 지정할 수도 있습니다. 그러면 Init 에서 이 정보를 사용하여 레지스트리에서 루트 키를 찾습니다. 다른 IQueryAssociations 메서드에 대한 후속 호출은 이를 시작점으로 사용하고 루트 키의 하위 키에서 정보를 검색합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 2000 Professional, Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 shlwapi.h
라이브러리 Shlwapi.lib
DLL Shell32.dll(버전 5.0 이상)

추가 정보

IQueryAssociations