Перечисление ASSOCF

Статья
06/13/2023

Предоставляет сведения для методов интерфейса IQueryAssociations .

Синтаксис

typedef enum  {
    ASSOCF_NONE                  = 0x00000000,  
    ASSOCF_INIT_NOREMAPCLSID     = 0x00000001,  
    ASSOCF_INIT_BYEXENAME        = 0x00000002,  
    ASSOCF_OPEN_BYEXENAME        = 0x00000002,  
    ASSOCF_INIT_DEFAULTTOSTAR    = 0x00000004,  
    ASSOCF_INIT_DEFAULTTOFOLDER  = 0x00000008,  
    ASSOCF_NOUSERSETTINGS        = 0x00000010,  
    ASSOCF_NOTRUNCATE            = 0x00000020,  
    ASSOCF_VERIFY                = 0x00000040,  
    ASSOCF_REMAPRUNDLL           = 0x00000080,  
    ASSOCF_NOFIXUPS              = 0x00000100,  
    ASSOCF_IGNOREBASECLASS       = 0x00000200,  
    ASSOCF_INIT_IGNOREUNKNOWN    = 0x00000400,  
    ASSOCF_INIT_FIXED_PROGID     = 0x00000800,  
    ASSOCF_IS_PROTOCOL           = 0x00001000,  
    ASSOCF_INIT_FOR_FILE         = 0x00002000
} ASSOCF;

Константы

ASSOCF_NONE

Ни один из следующих параметров не задан.

ASSOCF_INIT_NOREMAPCLSID

Указывает методам интерфейса IQueryAssociations не сопоставлять значения CLSID со значениями ProgID.

ASSOCF_INIT_BYEXENAME

Определяет значение параметра pwszAssocобъекта IQueryAssociations::Init в качестве имени исполняемого файла. Если этот флаг не установлен, корневому ключу будет присвоен идентификатор ProgID, связанный с ключом.exe , а не progID исполняемого файла.

ASSOCF_OPEN_BYEXENAME

Идентично ASSOCF_INIT_BYEXENAME.

ASSOCF_INIT_DEFAULTTOSTAR

Указывает, что если метод IQueryAssociations не находит запрошенное значение в корневом ключе, он должен попытаться получить сравнимое значение из подраздела * .

ASSOCF_INIT_DEFAULTTOFOLDER

Указывает, что если метод IQueryAssociations не находит запрошенное значение в корневом ключе, он должен попытаться получить сравнимое значение из подраздела Folder .

ASSOCF_NOUSERSETTINGS

Указывает, что поиск должен выполняться только HKEY_CLASSES_ROOT и что HKEY_CURRENT_USER следует игнорировать.

ASSOCF_NOTRUNCATE

Указывает, что возвращаемая строка не должна быть усечена. Вместо этого верните значение ошибки и требуемый размер для полной строки.

ASSOCF_VERIFY

Указывает методам IQueryAssociations проверить точность данных. Этот параметр позволяет методам IQueryAssociations считывать данные с жесткого диска пользователя для проверки. Например, они могут проверка понятное имя в реестре с именем, хранящимся в .exe файле. Установка этого флага обычно снижает эффективность метода .

ASSOCF_REMAPRUNDLL

Указывает методу IQueryAssociations игнорировать Rundll.exe и возвращать сведения о целевом объекте. Обычно методы IQueryAssociations возвращают сведения о первом .exe или .dll в командной строке. Если команда использует Rundll.exe, установка этого флага указывает методу игнорировать Rundll.exe и возвращать сведения о целевом объекте.

ASSOCF_NOFIXUPS

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

ASSOCF_IGNOREBASECLASS

Указывает, что значение BaseClass следует игнорировать.

ASSOCF_INIT_IGNOREUNKNOWN

Представлено в Windows 7. Указывает, что progID "Unknown" следует игнорировать; вместо этого сбой.

ASSOCF_INIT_FIXED_PROGID

Представлено в Windows 8. Указывает, что предоставленный Идентификатор ProgID должен сопоставляться с использованием системных значений по умолчанию, а не текущих пользовательских значений по умолчанию.

ASSOCF_IS_PROTOCOL

Представлено в Windows 8. Указывает, что значение является протоколом и должно быть сопоставлено с использованием значений по умолчанию текущего пользователя.

ASSOCF_INIT_FOR_FILE

Представлено в Windows 8.1. Указывает, что ProgID соответствует сопоставлению на основе расширения файла. Используйте вместе с ASSOCF_INIT_FIXED_PROGID.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional, Windows XP [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Заголовок	Shlwapi.h

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

AssocQueryKeyAssocQueryStringAssocQueryStringByKey