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

Статья
11/20/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, с дополнительными сведениями о расположении строки. Обычно для него задана команда оболочки, например открыть. Задайте для этого параметра значение NULL, если он не используется.

[out] phkeyOut

Тип: HKEY*

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

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

Тип: HRESULT

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

Замечания

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

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный, Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	shlwapi.h
библиотеки	Shlwapi.lib
DLL	Shlwapi.dll (версия 5.0 или более поздняя версия)

Поделиться через