Функция ShellExecuteExA (shellapi.h)

Выполняет операцию с указанным файлом.

Синтаксис

BOOL ShellExecuteExA(
  [in, out] SHELLEXECUTEINFOA *pExecInfo
);

Параметры

[in, out] pExecInfo

Тип: SHELLEXECUTEINFO*

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

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

Тип: BOOL

В случае успешного выполнения возвращает значение TRUE ; в противном случае — FALSE. Вызовите GetLastError для получения расширенных сведений об ошибке.

Комментарии

Так как ShellExecuteEx может делегировать выполнение расширениям оболочки (источникам данных, обработчикам контекстного меню, реализациям команд), которые активируются с помощью модели COM, com следует инициализировать перед вызовом ShellExecuteEx . Для некоторых расширений оболочки требуется тип однопотоковых квартир (STA) COM. В этом случае com следует инициализировать, как показано ниже:

CoInitializeEx(NULL, COINIT_APARTMENTTHREADED | COINIT_DISABLE_OLE1DDE)

Существуют экземпляры, в которых ShellExecuteEx не использует один из этих типов расширения оболочки, и эти экземпляры вообще не требуют инициализации COM. Тем не менее рекомендуется всегда инициализировать COM перед использованием этой функции.

Когда библиотеки DLL загружаются в процесс, вы получаете блокировку, известную как блокировка загрузчика. Функция DllMain всегда выполняется под блокировкой загрузчика. Важно не вызывать ShellExecuteEx при удержании блокировки загрузчика. Так как ShellExecuteEx является расширяемым, вы можете загрузить код, который не работает должным образом при наличии блокировки загрузчика, что может привести к взаимоблокировке и, следовательно, к неотвеченному потоку.

При использовании нескольких мониторов, если указать HWND и задать элемент lpVerb структуры SHELLEXECUTEINFO , на которую указывает lpExecInfo , значение "Свойства", все окна, созданные командой ShellExecuteEx, могут отображаться в неправильном положении.

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

SE_ERR_XXX значения ошибок предоставляются для совместимости с ShellExecute. Чтобы получить более точные сведения об ошибке, используйте GetLastError. Он может возвращать одно из следующих значений.

Открытие элементов из URL-адреса Вы можете зарегистрировать приложение для активации при передаче URL-адресов. Вы также можете указать, какие протоколы поддерживает приложение. Дополнительные сведения см. в разделе Регистрация приложений .

Поддержка цепочки сайтов Начиная с Windows 8, вы можете предоставить указатель цепочки сайтов на функцию ShellExecuteEx для поддержки активации элементов с помощью служб с этого сайта. Дополнительные сведения см. в статье Запуск приложений (ShellExecute, ShellExecuteEx, SHELLEXECUTEINFO).

Требования

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

CoInitializeEx

IShellExecuteHook

Запуск приложений (ShellExecute, ShellExecuteEx, SHELLEXECUTEINFO)

ShellExecute