Метод 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 .

• ASSOCF_INIT_BYEXENAME
• ASSOCF_INIT_DEFAULTTOFOLDER
• ASSOCF_INIT_DEFAULTTOSTAR

[in, optional] pszAssoc

Тип: LPCWSTR

Строка Юникода, используемая для определения корневого ключа. Если для hkProgid задано значение , задайте для этого параметра значение NULL. Можно использовать четыре типа строк:

Расширение имени файла

Расширение имени файла, например .txt.

CLSID

ИДЕНТИФИКАТОР GUID CLSID в стандартном формате "{GUID}".

ProgID:

Идентификатор ProgID приложения, например Word. Document.8.

Имя исполняемого файла

Имя файла .exe приложения. Флаг ASSOCF_OPEN_BYEXENAME должен быть установлен в формате flags.

[in, optional] hkProgid

Тип: HKEY

Значение HKEY подраздела, используемого в качестве корневого ключа. Поиск выполняется только под этим ключом. Если для pwszAssoc задано значение , задайте для этого параметра значение NULL.

[in, optional] hwnd

Тип: HWND

Возвращаемое значение

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Этот метод инициализирует интерфейс и вызывается каждый раз, когда требуется указать новый корневой ключ. С помощью pwszAssoc можно указать строку, например расширение имени файла или связанный с ним Идентификатор ProgID, который идентифицирует корневой ключ. Можно также указать значение HKEY корневого ключа. Затем init будет использовать эти сведения для поиска корневого раздела в реестре. Последующие вызовы других методов IQueryAssociations будут использовать его в качестве отправной точки и выполнять поиск сведений в подразделах корневого ключа.

Требования

См. также раздел

IQueryAssociations