Регистрация приложения

В этом разделе рассматривается, как приложения могут предоставлять сведения о себе, необходимые для реализации определенных сценариев. Сюда входят сведения, необходимые для поиска приложения, команды, поддерживаемые приложением, и типы файлов, которые может обрабатывать приложение.

Этот раздел организован следующим образом:

• Поиск исполняемого файла приложения
• Регистрация приложений
  • Использование подраздела "Пути к приложениям"
  • Использование подраздела "Приложения"
• Регистрация глаголов и других сведений о сопоставлении файлов
• Регистрация воспринимаемого типа
• Связанные темы

Поиск исполняемого файла приложения

Если функция ShellExecuteEx вызывается с именем исполняемого файла в параметре lpFile , существует несколько мест, где функция ищет файл. Рекомендуется зарегистрировать приложение в подразделе реестра Пути к приложениям . Это позволяет избежать необходимости для приложений изменять системную переменную среды PATH.

Файл ищется в следующих расположениях:

• текущий рабочий каталог.
• Только каталог Windows (поиск подкаталогов не выполняется).
• Каталог Windows\System32 .
• Каталоги, перечисленные в переменной среды PATH.
• Рекомендуется: HKEY_LOCAL_MACHINE\software\Microsoft\Windows\CurrentVersion\App Paths

Регистрация приложений

Подразделы реестра "Пути к приложениям" и "Приложения" используются для регистрации и управления поведением системы от имени приложений. Подраздел Пути к приложениям является предпочтительным расположением.

Использование подраздела "Пути к приложениям"

В Windows 7 и более поздних версиях настоятельно рекомендуется устанавливать приложения для каждого пользователя, а не для компьютера. Приложение, установленное для каждого пользователя, можно зарегистрировать в разделе HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\App Paths. Приложение, установленное для всех пользователей компьютера, можно зарегистрировать в разделе HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\App Paths.

Записи, найденные в разделе Пути к приложениям , используются в основном для следующих целей:

• Сопоставление имени исполняемого файла приложения с полным путем к нему.
• Предварительное добавление сведений в переменную среды PATH для каждого приложения или процесса.

Если имя подраздела Пути к приложению совпадает с именем файла, оболочка выполняет два действия:

• Запись (по умолчанию) используется в качестве полного пути к файлу.
• Запись Path для этого подраздела предварительно добавлена в переменную среды PATH этого процесса. Если это не требуется, значение Path можно опустить.

Потенциальные проблемы, о которых следует знать, включают:

• Оболочка ограничивает длину командной строки MAX_PATH * 2 символами. Если в качестве записей реестра указано много файлов или их пути длинные, имена файлов в списке могут быть потеряны из-за усечения командной строки.
• Некоторые приложения не принимают несколько имен файлов в командной строке.
• Некоторые приложения, принимаюющие несколько имен файлов, не распознают формат, в котором их предоставляет оболочка. Оболочка предоставляет список параметров в виде строки в кавычках, но для некоторых приложений могут потребоваться строки без кавычек.
• Не все элементы, которые можно перетаскивать, являются частью файловой системы; например, принтеры. У этих элементов нет стандартного пути Win32, поэтому невозможно предоставить значимое значение lpParametersдля ShellExecuteEx.

Использование записи DropTarget позволяет избежать этих потенциальных проблем, предоставляя доступ ко всем форматам буфера обмена, включая CFSTR_SHELLIDLIST (для длинных списков файлов) и CFSTR_FILECONTENTS (для объектов, не относящихся к файловой системе).

Чтобы зарегистрировать и контролировать поведение приложений с помощью подраздела Пути к приложениям:

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

   HKEY_LOCAL_MACHINE or HKEY_CURRENT_USER
      SOFTWARE
         Microsoft
            Windows
               CurrentVersion
                  App Paths
                     file.exe
                        (Default)
                        DontUseDesktopChangeRouter
                        DropTarget
                        Path
                        UseUrl
   

2. Дополнительные сведения о записях подраздела Пути к приложениям см. в следующей таблице.

Использование подраздела "Приложения"

Благодаря включению записей реестра в подраздел HKEY_CLASSES_ROOT\Приложения\ApplicationName.exe приложения могут предоставлять сведения, относящиеся к конкретному приложению, как показано в следующей таблице.

Примеры

Ниже приведены некоторые примеры регистрации приложений с помощью подраздела HKEY_CLASSES_ROOT\Applications\ApplicationName.exe . Все значения записей реестра имеют REG_SZ тип, за исключением DefaultIcon , который имеет REG_EXPAND_SZ тип.

HKEY_CLASSES_ROOT
   Applications
      wordpad.exe
         FriendlyAppName = @%SystemRoot%\System32\shell32.dll,-22069

HKEY_CLASSES_ROOT
   Applications
      wmplayer.exe
         SupportedTypes
            .3gp2

HKEY_CLASSES_ROOT
   Applications
      wmplayer.exe
         DefaultIcon
            (Default) = %SystemRoot%\system32\wmploc.dll,-730

HKEY_CLASSES_ROOT
   Applications
      WScript.exe
         NoOpenWith

HKEY_CLASSES_ROOT
   Applications
      photoviewer.dll
         shell
            open
               DropTarget
                  Clsid = {FFE2A43C-56B9-4bf5-9A79-CC6D4285608A}

HKEY_CLASSES_ROOT
   Applications
      mspaint.exe
         SupportedTypes
            .bmp
            .dib
            .rle
            .jpg
            .jpeg
            .jpe
            .jfif
            .gif
            .emf
            .wmf
            .tif
            .tiff
            .png
            .ico

Регистрация глаголов и других сведений о сопоставлении файлов

Подразделы, зарегистрированные в HKEY_CLASSES_ROOT\SystemFileAssociations , позволяют оболочке определять поведение атрибутов по умолчанию для типов файлов и включать сопоставления общих файлов. Когда пользователи изменяют приложение по умолчанию для типа файла, ProgID нового приложения по умолчанию имеет приоритет при предоставлении команд и других сведений о связи. Этот приоритет обусловлен тем, что он является первой записью в массиве сопоставлений. Если программа по умолчанию изменена, сведения, указанные в предыдущем ProgID, больше не будут доступны.

Чтобы заблаговременно справляться с последствиями изменения программ по умолчанию, можно использовать HKEY_CLASSES_ROOT\SystemFileAssociations для регистрации глаголов и других сведений о связи. Из-за расположения после ProgID в массиве сопоставлений эти регистрации имеют более низкий приоритет. Эти системы SystemFileAssociationsregistrations являются стабильными, даже если пользователи изменяют программы по умолчанию и предоставляют расположение для регистрации дополнительных команд, которые всегда будут доступны для определенного типа файлов. Пример реестра см. в разделе Регистрация воспринимаемого типа далее в этом разделе.

В следующем примере реестра показано, что происходит, когда пользователь запускает элемент Программы по умолчанию в панель управления изменить значение по умолчанию для .mp3 файлов на App2ProgID. После изменения значения по умолчанию Verb1 больше недоступен, а Verb2 становится значением по умолчанию.

HKEY_CLASSES_ROOT
   .mp3
      (Default) = App1ProgID

HKEY_CLASSES_ROOT
   App1ProgID
      shell
         Verb1

HKEY_CLASSES_ROOT
   App2ProgID
      shell
         Verb2

Регистрация воспринимаемого типа

Значения реестра для воспринимаемых типов определяются как подразделы подраздела реестра HKEY_CLASSES_ROOT\SystemFileAssociations . Например, воспринимаемый текст типа регистрируется следующим образом:

HKEY_CLASSES_ROOT
   SystemFileAssociations
      text
         shell
            edit
               command
                  (Default) = "%SystemRoot%\system32\NOTEPAD.EXE" "%1"
            open
               command
                  (Default) = "%SystemRoot%\system32\NOTEPAD.EXE" "%1"

Предполагаемый тип файла указывается путем включения значения PerceivedType в подраздел типа файла. В качестве значения PerceivedType задается имя воспринимаемого типа, зарегистрированного в подразделе реестра HKEY_CLASSES_ROOT\SystemFileAssociations , как показано в предыдущем примере реестра. Например, чтобы объявить CPP-файлы как файлы воспринимаемого типа "text", добавьте следующую запись реестра:

HKEY_CLASSES_ROOT
   .cpp
      PerceivedType = text

Связанные темы

Типы файлов

Принцип работы сопоставлений файлов

Просмотр содержимого по типу или типу файла

Средство проверки типов файлов

Обработчики типов файлов

Программные идентификаторы

Воспринимаемые типы

Массивы ассоциаций