On-line справка по Win32 API

БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!

A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать

ShellExecute

The ShellExecute function opens or prints a specified file. The file can be an executable file or a document file. See ShellExecuteEx also.

HINSTANCE ShellExecute(

HWND hwnd, // handle to parent window
LPCTSTR lpOperation, // pointer to string that specifies operation to perform
LPCTSTR lpFile, // pointer to filename or folder name string
LPCTSTR lpParameters, // pointer to string that specifies executable-file parameters
LPCTSTR lpDirectory, // pointer to string that specifies default directory
INT nShowCmd // whether file is shown when opened
);

Parameters

hwnd

Specifies a parent window. This window receives any message boxes that an application produces. For example, an application may report an error by producing a message box.

lpOperation

Pointer to a null-terminated string that specifies the operation to perform. The following operation strings are valid:

String Meaning
"open" The function opens the file specified by lpFile. The file can be an executable file or a document file. The file can be a folder to open.
"print" The function prints the file specified by lpFile. The file should be a document file. If the file is an executable file, the function opens the file, as if "open" had been specified.
"explore" The function explores the folder specified by lpFile.

The lpOperation parameter can be NULL. In that case, the function opens the file specified by lpFile.

lpFile

Pointer to a null-terminated string that specifies the file to open or print or the folder to open or explore. The function can open an executable file or a document file. The function can print a document file.

lpParameters

If lpFile specifies an executable file, lpParameters is a pointer to a null-terminated string that specifies parameters to be passed to the application.
If lpFile specifies a document file, lpParameters should be NULL.

lpDirectory

Pointer to a null-terminated string that specifies the default directory.

nShowCmd

If lpFile specifies an executable file, nShowCmd specifies how the application is to be shown when it is opened. This parameter can be one of the following values:

Value Meaning
SW_HIDE Hides the window and activates another window.
SW_MAXIMIZE Maximizes the specified window.
SW_MINIMIZE Minimizes the specified window and activates the next top-level window in the Z order.
SW_RESTORE Activates and displays the window. If the window is minimized or maximized, Windows restores it to its original size and position. An application should specify this flag when restoring a minimized window.
SW_SHOW Activates the window and displays it in its current size and position.
SW_SHOWDEFAULT Sets the show state based on the SW_ flag specified in the STARTUPINFO structure passed to the CreateProcess function by the program that started the application. An application should call ShowWindow with this flag to set the initial show state of its main window.
SW_SHOWMAXIMIZED Activates the window and displays it as a maximized window.
SW_SHOWMINIMIZED Activates the window and displays it as a minimized window.
SW_SHOWMINNOACTIVE Displays the window as a minimized window. The active window remains active.
SW_SHOWNA Displays the window in its current state. The active window remains active.
SW_SHOWNOACTIVATE Displays a window in its most recent size and position. The active window remains active.
SW_SHOWNORMAL Activates and displays a window. If the window is minimized or maximized, Windows restores it to its original size and position. An application should specify this flag when displaying the window for the first time.

If lpFile specifies a document file, nShowCmd should be zero.

Return Values

If the function succeeds, the return value is the instance handle of the application that was run, or the handle of a dynamic data exchange (DDE) server application.
If the function fails, the return value is an error value that is less than or equal to 32. The following table lists these error values:

Value Meaning
0 The operating system is out of memory or resources.
ERROR_FILE_NOT_FOUND The specified file was not found.
ERROR_PATH_NOT_FOUND The specified path was not found.
ERROR_BAD_FORMAT The .EXE file is invalid (non-Win32 .EXE or error in .EXE image).
SE_ERR_ACCESSDENIED The operating system denied access to the specified file.
SE_ERR_ASSOCINCOMPLETE The filename association is incomplete or invalid.
SE_ERR_DDEBUSY The DDE transaction could not be completed because other DDE transactions were being processed.
SE_ERR_DDEFAIL The DDE transaction failed.
SE_ERR_DDETIMEOUT The DDE transaction could not be completed because the request timed out.
SE_ERR_DLLNOTFOUND The specified dynamic-link library was not found.
SE_ERR_FNF The specified file was not found.
SE_ERR_NOASSOC There is no application associated with the given filename extension.
SE_ERR_OOM There was not enough memory to complete the operation.
SE_ERR_PNF The specified path was not found.
SE_ERR_SHARE A sharing violation occurred.

Remarks

The file specified by the lpFile parameter can be a document file or an executable file. If the file is a document file, the ShellExecute function opens or prints it, depending on the value of the lpOperation parameter. If the file is an executable file, the ShellExecute function opens it, even if lpOperation specifies printing.
You can use ShellExecute to open or explore a shell folder. To open a folder, use either of the following calls:

ShellExecute(handle, NULL, path_to_folder, NULL, NULL, SW_SHOWNORMAL);

or

ShellExecute(handle, "open", path_to_folder, NULL, NULL, SW_SHOWNORMAL);

To explore a folder, use the following call:

ShellExecute(handle, "explore", path_to_folder, NULL, NULL, SW_SHOWNORMAL);

If lpOperation is NULL, the function opens the file specified by lpFile. If lpOperation is "open" or "explore", the function will force an open window or explorer.

See Also

FindExecutable, ShellExecuteEx

Пригласи друзей и счет твоего мобильника всегда будет положительным!

Пригласи друзей и счет твоего мобильника всегда будет положительным!

ShellExecute

Функция ShellExecute открывает или печатает определенный файл. Файл может быть выполняемым файлом или файл документа. Смотри ShellExecuteEx также.

HINSTANCE ShellExecute(

HWND hwnd, // РУЧКА в родительское окно LPCTSTR lpOperation, // указатель, чтобы нанизывать, что определяет действие, чтобы выполнять LPCTSTR lpFile, // указателю в filename или строку имени папки LPCTSTR lpParameters, // указателя, чтобы нанизывать, что определяет выполняемые-файловые параметры LPCTSTR lpDirectory, // указатель, чтобы нанизывать, что определяет что встроенный независимо файл директория INT nShowCmd // показан когда открыто
);

Параметры

hwnd

Определяет родительское окно. Это окно получает любые ящики сообщения, что приложение производит. Например, приложение может сообщить ошибку производя ящик сообщения.

lpOperation

Указатель в недействительный расторгнутую строку, которая определяет действие, чтобы выполняться. Следующие строки действия в силе:

Значение Строки
"открытый" функция открывает файл определенный lpFile. Файл может быть выполняемым файлом или файл документа. Файл может быть папкой, чтобы открываться.
"отпечаток" функция печатает файл определенный lpFile. Файл должен быть файлом документа. Если файл является выполняемым файлом, функция открывает файл, как будто "открытый" был определен.
"изучать" функция изучает папку определенную lpFile.

Параметр lpOperation может быть НЕДЕЙСТВИТЕЛЕН. В этом случае, функция открывает файл определенный lpFile.

lpFile

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

lpParameters

Если lpFile определяет выполняемый файл, lpParameters - указатель в недействительный расторгнутой строке, которая определяет параметры, которые нужно проходить в приложение.
Если lpFile определяет файл документа, lpParameters должен быть НЕДЕЙСТВИТЕЛЕН.

lpDirectory

Указатель в недействительный расторгнутую строку, которая определяет встроенный директорий.

nShowCmd

Если lpFile определяет выполняемый файл, nShowCmd определяет как приложение должно быть показано когда оно открыто. Этот параметр может быть одним из следующего величин:

Значение Величины
SW_HIDE Прячут окно и активизируют другое окно.
SW_MAXIMIZE Расширяет определенное окно.
SW_MINIMIZE Минимизирует определенное окно и активизирует следующее окно верхнего уровня в порядке Z.
SW_RESTORE Активизирует и отображает окно. Если окно минимизировано или расширено, Окно восстанавливает это в свой оригинальный размер и позицию. Приложение должно определить этот флаг при восстановлении минимизированного окна.
SW_SHOW Активизирует окно и отображает это в своем текущем размере и позиции.
SW_SHOWDEFAULT Устанавливает состояние показа основанное на флаге SW_ определенном в структуре STARTUPINFO пройденном в функцию CreateProcess программой, которая начинала приложение. Приложение должно вызывать ShowWindow с этим флагом, чтобы устанавливать начальное состояние показа своего основного окна.
SW_SHOWMAXIMIZED Активизирует окно и отображает это как расширенное окно.
SW_SHOWMINIMIZED Активизирует окно и отображает это как минимизированное окно.
SW_SHOWMINNOACTIVE Отображает окно как минимизированное окно. Активное окно остается активным.
SW_SHOWNA Отображает окно в своем текущем состоянии. Активное окно остается активным.
SW_SHOWNOACTIVATE Отображает окну в своем наиболее последнем размере и позиции. Активное окно остается активным.
SW_SHOWNORMAL Активизирует и отображает окно. Если окно минимизировано или расширено, Окно восстанавливает это в свой оригинальный размер и позицию. Приложение должно определить этот флаг при отображении окна впервые.

Если lpFile определяет файл документа, nShowCmd должен - нулевым.

Обратные Величины

Если функция добивается успеха, обратная величина является ручкой примера приложения, которая работала, или ручка динамического обмена данных сервера (DDE) приложение.
Если функция терпит неудачу, обратная величина является величиной ошибки, которая - менее чем или равная 32. Следующая таблица включает эти величины ошибки:

Значение Величины
0 Операционная система - из памяти или ресурсов.
ERROR_FILE_NOT_FOUND определенный файл не был обнаружен.
ERROR_PATH_NOT_FOUND определенный путь не был обнаружен.
ERROR_BAD_FORMAT файл .EXE недействителен (non-Win32 .EXE или ошибка в образе .EXE).
SE_ERR_ACCESSDENIED операционная система запрещала доступ к определенному файлу.
SE_ERR_ASSOCINCOMPLETE ассоциация filename - неполная или неправильная.
SE_ERR_DDEBUSY сделка DDE не могла завершана поскольку другие сделки DDE обрабатывались.
SE_ERR_DDEFAIL сделка DDE терпела неудачу.
SE_ERR_DDETIMEOUT сделка DDE не могла завершана поскольку запрос синхронизированный.
SE_ERR_DLLNOTFOUND динамическая связь определенной библиотеки не была обнаружена.
SE_ERR_FNF определенный файл не был обнаружен.
SE_ERR_NOASSOC Нет приложения связывался данным filename расширением.
SE_ERR_OOM Было не достаточно памяти, чтобы завершать операцию.
SE_ERR_PNF определенный путь не был обнаружен.
SE_ERR_SHARE использующее нарушение происходило.

Замечания

Файл определенный параметром lpFile может быть файлом документа или выполняемый файл. Если файл - файл документа, ShellExecute функциональные открытые или распечатки это, в зависимости от величины параметра lpOperation. Если файл - выполняемый файл, ShellExecute функциональный открытый это, даже если бы lpOperation определяет печать.
Вы можете использовать ShellExecute, чтобы открывать или изучать папку оболочки. Для того, чтобы открывать папку, используйте любое из следующего вызовов:

ShellExecute(РУЧКА, НЕДЕЙСТВИТЕЛЬНАЯ, path_to_folder, НЕДЕЙСТВИТЕЛЬНЫЙ, НЕДЕЙСТВИТЕЛЬНЫЙ, SW_SHOWNORMAL);

или

ShellExecute(РУЧКА, "открытый", path_to_folder, НЕДЕЙСТВИТЕЛЬНЫЙ, НЕДЕЙСТВИТЕЛЬНЫЙ, SW_SHOWNORMAL);

Для того, чтобы изучать папку, используйте следующее вызова:

ShellExecute(РУЧКА, "изучать", path_to_folder, НЕДЕЙСТВИТЕЛЬНЫЙ, НЕДЕЙСТВИТЕЛЬНЫЙ, SW_SHOWNORMAL);

Если lpOperation НЕДЕЙСТВИТЕЛЕН, функция открывает файл определенный lpFile. Если lpOperation "открытый" или "изучать", функцию заставит открытое окно или исследователя.

Смотри Также

FindExecutable, ShellExecuteEx

Используются технологии uCoz