Функция AssocQueryKeyA (shlwapi.h)

Статья
03/05/2024

Ищет и извлекает из реестра ключ, связанный с файлом или протоколом.

Синтаксис

LWSTDAPI AssocQueryKeyA(
  [in]  ASSOCF   flags,
  [in]  ASSOCKEY key,
  [in]  LPCSTR   pszAssoc,
  [in]  LPCSTR   pszExtra,
  [out] HKEY     *phkeyOut
);

Параметры

[in] flags

Тип: ASSOCF

Флаги, которые можно использовать для управления поиском. Это может быть любое сочетание значений ASSOCF , за исключением того, что может быть включено только одно значение ASSOCF_INIT.

[in] key

Тип: ASSOCKEY

Значение ASSOCKEY , указывающее тип возвращаемого ключа.

[in] pszAssoc

Тип: LPCTSTR

Указатель на строку, завершающуюся null, которая используется для определения корневого ключа. Можно использовать четыре типа строк.

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

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

CLSID

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

ProgID:

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

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

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

[in] pszExtra

Тип: LPCTSTR

Указатель на необязательную строку, завершаемую значением NULL, с дополнительными сведениями о расположении строки. Обычно для нее задается команда оболочки, например open. Присвойте этому параметру значение NULL , если он не используется.

[out] phkeyOut

Тип: HKEY*

Указатель на значение ключа HKEY.

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

Тип: HRESULT

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

Эта функция является оболочкой для интерфейса IQueryAssociations . Он предназначен для упрощения процесса использования интерфейса . Дополнительные сведения о том, как работают функции сопоставления файлов и протоколов, см. в разделе IQueryAssociations.

Примечание

Заголовок shlwapi.h определяет AssocQueryKey в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional, Windows XP [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	shlwapi.h
Библиотека	Shlwapi.lib
DLL	Shlwapi.dll (версия 5.0 или более поздняя)