Функция AssocQueryKeyA (shlwapi.h)
Ищет и извлекает из реестра ключ, связанный с файлом или протоколом.
Синтаксис
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 или более поздняя) |