Структура SHELLEXECUTEINFOA (shellapi.h)

Содержит сведения, используемые ShellExecuteEx.

Синтаксис

typedef struct _SHELLEXECUTEINFOA {
  DWORD     cbSize;
  ULONG     fMask;
  HWND      hwnd;
  LPCSTR    lpVerb;
  LPCSTR    lpFile;
  LPCSTR    lpParameters;
  LPCSTR    lpDirectory;
  int       nShow;
  HINSTANCE hInstApp;
  void      *lpIDList;
  LPCSTR    lpClass;
  HKEY      hkeyClass;
  DWORD     dwHotKey;
  union {
    HANDLE hIcon;
    HANDLE hMonitor;
  } DUMMYUNIONNAME;
  HANDLE    hProcess;
} SHELLEXECUTEINFOA, *LPSHELLEXECUTEINFOA;

Члены

cbSize

Тип: DWORD

Обязательно. Размер этой структуры в байтах.

fMask

Тип: ULONG

Сочетание одного или нескольких из следующих значений, указывающих на содержимое и допустимость других элементов структуры:

hwnd

Тип: HWND

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

lpVerb

Тип: LPCTSTR

Строка, называемая командой, которая указывает выполняемое действие. Набор доступных команд зависит от конкретного файла или папки. Как правило, действия, доступные в контекстном меню объекта, доступные в контекстном меню, доступны. Этот параметр может быть значение NULL, в этом случае используется команда по умолчанию, если она доступна. Если нет, используется команда open. Если ни глаголы не доступны, система использует первую команду, указанную в реестре. Если нет причины ограничить действие определенной командой, передайте NULL для использования вычисляемого по умолчанию. Это необходимо в некоторых случаях, например при указании SEE_MASK_FLAG_NO_UI и намерении создать пользовательский интерфейс Open With, если приложения не установлены.

Часто используются следующие команды:

• изменить: запускает редактор и открывает документ для редактирования. Если lpFile не является файлом документа, функция завершится ошибкой.
• изучить: просматривает папку, указанную lpFile.
• найти: инициирует поиск, начиная с указанного каталога.
• открыть: открывает файл, указанный параметром lpFile. Файл может быть исполняемым файлом, файлом документа или папкой.
• openas: запускает пользовательский интерфейс средства выбора, позволяющий пользователю выбрать приложение, с помощью которого открыть файл, указанный параметром lpFile.
• печати: выводит файл документа, указанный lpFile. Если lpFile не является файлом документа, функция завершится ошибкой.
• свойства: отображает свойства файла или папки.
• запуска: запускает приложение от имени администратора. Контроль учетных записей пользователей (UAC) предложит пользователю предоставить согласие на запуск приложения с повышенными привилегиями или ввести учетные данные учетной записи администратора, используемой для запуска приложения.

lpFile

Тип: LPCTSTR

Адрес строки, завершаемой значением NULL, указывающей имя файла или объекта, на котором ShellExecuteExecuteEx выполнит действие, указанное параметром lpVerb. Системные команды реестра, поддерживаемые функцией shellExecuteExecuteEx, включают "open" для исполняемых файлов и файлов документов и "печать" для файлов документов, для которых был зарегистрирован обработчик печати. Другие приложения могли добавлять команды оболочки через системный реестр, например "воспроизведение" для .avi и .wav файлов. Чтобы указать объект пространства имен Оболочки, передайте полное имя синтаксического анализа и задайте флаг SEE_MASK_INVOKEIDLIST в параметре fMask.

lpParameters

Тип: LPCTSTR

Необязательный. Адрес строки, завершаемой значением NULL, содержащей параметры приложения. Параметры должны быть разделены пробелами. Если элемент lpFile указывает файл документа, lpParameters должен быть NULL.

lpDirectory

Тип: LPCTSTR

Необязательный. Адрес строки, завершаемой значением NULL, указывающей имя рабочего каталога. Если этот элемент null, текущий каталог используется в качестве рабочего каталога.

nShow

Тип: int

Обязательно. Флаги, указывающие, как приложение должно отображаться при открытии; одно из значений SW_, перечисленных для функции ShellExecute. Если lpFile указывает файл документа, флаг просто передается связанному приложению. Это до приложения, чтобы решить, как его обрабатывать.

hInstApp

Тип: HINSTANCE

[out] Если задано SEE_MASK_NOCLOSEPROCESS, а вызов ShellExecuteExecuteEx выполнен успешно, он задает этому элементу значение больше 32. Если функция завершается ошибкой, она имеет значение ошибки SE_ERR_XXX, указывающее причину сбоя. Хотя hInstApp объявлен как HINSTANCE для совместимости с 16-разрядными приложениями Windows, это не правда HINSTANCE. Его можно привести только к int и по сравнению с 32 или следующими кодами ошибок SE_ERR_XXX.

lpIDList

Тип: LPVOID

Адрес абсолютной структуры ITEMIDLIST (PCIDLIST_ABSOLUTE) для хранения списка идентификаторов элементов, который однозначно идентифицирует файл для выполнения. Этот элемент игнорируется, если элемент fMask не включает SEE_MASK_IDLIST или SEE_MASK_INVOKEIDLIST.

lpClass

Тип: LPCTSTR

Адрес строки, завершаемой значением NULL, указывающей одно из следующих значений:

• A ProgId. Например, "Paint.Picture".
• Схема протокола URI. Например, http.
• Расширение файла. Например, ".txt".
• Путь реестра в HKEY_CLASSES_ROOT, который называет подраздел, содержащий одну или несколько команд оболочки. Этот раздел будет иметь подраздел, соответствующий схеме реестра команд оболочки, например оболочке\имени команды.

Этот элемент игнорируется, если fMask не включает SEE_MASK_CLASSNAME.

hkeyClass

Тип: HKEY

Дескриптор раздела реестра для типа файла. Права доступа для этого раздела реестра должны иметь значение KEY_READ. Этот элемент игнорируется, если fMask не включает SEE_MASK_CLASSKEY.

dwHotKey

Тип: DWORD

Сочетание клавиш для связывания с приложением. Слово с низким порядком — это код виртуального ключа, а слово с высоким порядком — это флаг модификатора (HOTKEYF_). Список флагов модификатора см. в описании сообщения WM_SETHOTKEY. Этот элемент игнорируется, если fMask не включает SEE_MASK_HOTKEY.

DUMMYUNIONNAME

DUMMYUNIONNAME.hIcon

Тип: HANDLE

Дескриптор значка для типа файла. Этот элемент игнорируется, если fMask не включает SEE_MASK_ICON. Это значение используется только в Windows XP и более ранних версиях. Он игнорируется как Windows Vista.

DUMMYUNIONNAME.hMonitor

Тип: HANDLE

Дескриптор монитора, на котором должен отображаться документ. Этот элемент игнорируется, если fMask не включает SEE_MASK_HMONITOR.

hProcess

Тип: HANDLE

Дескриптор только что запущенного приложения. Этот элемент устанавливается при возврате и всегда null, если fMask не задано значение SEE_MASK_NOCLOSEPROCESS. Даже если задано значение SEE_MASK_NOCLOSEPROCESS, hProcess будет null, если процесс не был запущен. Например, если документ, который будет запущен, является URL-адресом и экземпляром Internet Explorer уже запущен, он отобразит документ. Новый процесс не запускается, и hProcess будет NULL.

Замечания

Флаг SEE_MASK_NOASYNC должен быть указан, если вызывающий поток ShellExecuteEx не имеет цикла сообщений или если поток или процесс завершится вскоре после возвращения ShellExecuteExecuteEx. В таких условиях вызывающий поток не будет доступен для завершения беседы DDE, поэтому важно, чтобы ShellExecute Ex завершить беседу, прежде чем возвращать управление вызывающему приложению. Сбой завершения беседы может привести к неудачном запуску документа.

Если вызывающий поток имеет цикл сообщений и будет существовать некоторое время после вызова ShellExecute Ex возвращается, флаг SEE_MASK_NOASYNC необязателен. Если флаг опущен, для завершения беседы DDE будет использоваться насос сообщения вызывающего потока. Вызывающее приложение быстрее восстанавливает управление, так как беседа DDE может быть завершена в фоновом режиме.

Чтобы включить двойные кавычки в lpParameters, заключите каждую отметку в пару кавычки, как показано в следующем примере.

sei.lpParameters = "An example: \"\"\"quoted text\"\"\"";

В этом случае приложение получает три параметра: , пример:и "кавычки".

Требования