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

Флаг, указывающий, как инициализировать поиск. Обычно это значение равно нулю, но оно также может принимать одно из следующих значений ASSOCF .

• ASSOCF_INIT_BYEXENAME
• ASSOCF_INIT_DEFAULTTOFOLDER
• ASSOCF_INIT_DEFAULTTOSTAR

[in, optional] pszAssoc

Тип: LPCWSTR

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

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

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

CLSID

GUID CLSID в стандартном формате "{GUID}".

ProgID

ProgID приложения, например Word.Document.8.

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

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

[in, optional] hkProgid

Тип: HKEY

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

[in, optional] hwnd

Тип: HWND

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

Тип: HRESULT

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

Замечания

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

Требования

См. также

IQueryAssociations