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 이상) |