На главную

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 | Скачать Вниз

SHELLEXECUTEINFO





Specifies an enumerated type that defines flags used with the IShellFolder::EnumObjects method.

The SHELLEXECUTEINFO structure contains information used by the ShellExecuteEx function.

typedef struct _SHELLEXECUTEINFO { // sei
DWORD cbSize;
ULONG fMask;
HWND hwnd;
LPCSTR lpVerb;
LPCSTR lpFile;
LPCSTR lpParameters;
LPCSTR lpDirectory;
int nShow;
HINSTANCE hInstApp;

// Optional members
LPVOID lpIDList;
LPCSTR lpClass;
HKEY hkeyClass;
DWORD dwHotKey;
HANDLE hIcon;
HANDLE hProcess;
} SHELLEXECUTEINFO, FAR *LPSHELLEXECUTEINFO;



Members

cbSize

Specifies the size, in bytes, of the structure.

fMask

This is an array of flags that indicate the content and validity of the other structure members. You can specify a combination of the following values:

Value Meaning
SEE_MASK_CLASSKEY Use the class key given by the hkeyClass member.
SEE_MASK_CLASSNAME Use the class name given by the lpClass member.
SEE_MASK_CONNECTNETDRV The lpFile member is a Universal Naming Convention (UNC) path of a file on a network. Validate the share and connect to a drive letter.
SEE_MASK_DOENVSUBST Expand any environment variables specified in the string given by the lpDirectory or lpFile member.
SEE_MASK_FLAG_DDEWAIT Wait for the DDE conversation to terminate before returning, if the ShellExecuteEx function causes a DDE conversation to start.
SEE_MASK_FLAG_NO_UI Do not display an error message box if an error occurs.
SEE_MASK_HOTKEY Use the hot key given by the dwHotKey member.
SEE_MASK_ICON Use the icon given by the hIcon member.
SEE_MASK_IDLIST Use the item identifier list given by the lpIDList member.
SEE_MASK_INVOKEIDLIST Use the item identifier list given by the lpIDList member to invoke an application. If this member is NULL, the function creates an item identifier list and invokes the application. SEE_MASK_INVOKEIDLIST overrides SEE_MASK_IDLIST.
SEE_MASK_NOCLOSEPROCESS Leave the process running after the ShellExecuteEx function exits. The hProcess member receives the handle of the process.


hwnd

Handle to the parent window for any message boxes that the system may produce while executing this function (for example, for error reporting).

lpVerb

Pointer to a string specifying the name of a verb. The verb specifies an action for the application to perform. This member defaults to "Open" if no verb is specified.

lpFile

Pointer to a list of null-terminated strings that specify the names of the files to open or print. The function can open an executable file or a document file. The function can print a document file. If the path is not included with a name, the current directory is assumed.

lpParameters

Pointer to a null-terminated string containing the application parameters. The parameters must be separated by spaces. To include double quotation marks, you must enclose the marks in double quotation marks, as in the following example:

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


In this case, the application receives three parameters: An, example:, and "quoted text".
If lpFile specifies a document file, lpParameters should be NULL.

lpDirectory

Pointer to a null-terminated string that specifies the name of the working directory. If this member is not specified, the current directory is used as the working directory.

nShow

Show flags. Can be one of the SW_ values described for the ShowWindow function. If lpFile specifies an executable file, nShow specifies how the application is to be shown when it is opened. If lpFile specifies a document file, nShow should be zero.

hInstApp

Handle to the instance of the application that was started or an error value if the application could not be started. (This handle could also be the handle of a dynamic data exchange [DDE] server application.) This member is set on return. Error values can be one of the following:

Value Meaning
SE_ERR_FNF File not found
SE_ERR_PNF Path not found
SE_ERR_ACCESSDENIED Access denied
SE_ERR_OOM Out of memory
SE_ERR_DLLNOTFOUND Dynamic-link library not found
SE_ERR_SHARE Cannot share open file
SE_ERR_ASSOCINCOMPLETE File association information not complete
SE_ERR_DDETIMEOUT DDE operation timed out
SE_ERR_DDEFAIL DDE operation failed
SE_ERR_DDEBUSY DDE operation busy
SE_ERR_NOASSOC File association not available


lpIDList

Pointer to an ITEMIDLIST structure that contains an item identifier list that uniquely identifies the file to execute. Ignored if fMask is not set to SEE_MASK_IDLIST.

lpClass

Pointer to a null-terminated string specifying the name of a file class or a globally unique identifier (GUID). Ignored if fMask is not set to SEE_MASK_CLASSNAME.

hkeyClass

Handle to the registry key for the file class. Ignored if fMask is not set to SEE_MASK_CLASSKEY.

dwHotKey

Hot key to associate with the application. The low-order word is the virtual-key code, and the high-order word is a modifier flag (HOTKEYF_). For a list of modifier flags, see the description of the WM_SETHOTKEY message. Ignored if fMask is not set to SEE_MASK_HOTKEY.

hIcon

Handle to the icon for the file class. Ignored if fMask is not set to SEE_MASK_ICON.

hProcess

Handle to the newly started application. This member is set on return and is always NULL if fMask is not set to SEE_MASK_NOCLOSEPROCESS.



See Also

ITEMIDLIST, ShellExecuteEx, ShowWindow, WM_SETHOTKEY


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

SHELLEXECUTEINFO





Определяет перечисленный тип, который определяет флаги использовался IShellFolder::метод EnumObjects.

Структура SHELLEXECUTEINFO содержит информацию использованную функцией ShellExecuteEx.

typedef struct _SHELLEXECUTEINFO { // sei DWORD cbSize;
ULONG fMask;
HWND hwnd;
LPCSTR lpVerb;
LPCSTR lpFile;
LPCSTR lpParameters;
LPCSTR lpDirectory;
int nShow;
HINSTANCE hInstApp;

// Дополнительные участники LPVOID lpIDList;
LPCSTR lpClass;
HKEY hkeyClass;
DWORD dwHotKey;
ПРООПЕРИРУЙТЕ hIcon;
ПРООПЕРИРУЙТЕ hProcess;
} SHELLEXECUTEINFO, ЗНАЧИТЕЛЬНО *LPSHELLEXECUTEINFO;



Участники

cbSize

Определяет размер, в байтах, структуры.

fMask

Это - массив флагов, которые указывают содержимое и достоверность других структурных участников. Вы можете определить комбинацию следующего величин:

Значение Величины
SEE_MASK_CLASSKEY Использует клавишу класса данную элементом hkeyClass.
SEE_MASK_CLASSNAME Использует имя класса данное элементом lpClass.
SEE_MASK_CONNECTNETDRV элемент lpFile является Универсальными ОБОЗНАЧЕНИЯМИ (UNC) путем файла в сети. Подтвердите акцию и подключайте к письму накопителя.
SEE_MASK_DOENVSUBST Расширяет любые переменные среды определенные в строке данной lpDirectory или элементом lpFile.
SEE_MASK_FLAG_DDEWAIT Ждет разговор DDE, чтобы завершаться перед возвратом, если функция ShellExecuteEx заставляет разговор DDE, чтобы запускаться.
SEE_MASK_FLAG_NO_UI не отображает блока сообщения ошибки если ошибка происходит.
SEE_MASK_HOTKEY Использует горячую клавишу данную элементом dwHotKey.
SEE_MASK_ICON Использует иконку данную элементом hIcon.
SEE_MASK_IDLIST Использует список идентификатора пункта данный элементом lpIDList.
SEE_MASK_INVOKEIDLIST Использует список идентификатора пункта данный элементом lpIDList, чтобы вводить приложение. Если этот элемент НЕДЕЙСТВИТЕЛЕН, функция создает список идентификатора пункта и вводит приложение. SEE_MASK_INVOKEIDLIST аннулирует SEE_MASK_IDLIST.
SEE_MASK_NOCLOSEPROCESS Оставляет процесс, выполняющий после функциональные выходы ShellExecuteEx. Элемент hProcess получает ручку процесса.


hwnd

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

lpVerb

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

lpFile

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

lpParameters

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

sei.lpParameters = " Пример: \"\"\"ссылавшееся на текст\"\"\"";


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

lpDirectory

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

nShow

Показ сигнализирует. Может быть одной из величин SW_ описанных для функции ShowWindow. Если lpFile определяет выполняемый файл, nShow определяет как приложение должно быть показано когда оно открыто. Если lpFile определяет файл документа, nShow должен - нулевым.

hInstApp

Прооперируйте пример приложения, которое было запущено или величина ошибки если приложение не могло запускано. (Эта ручка могла также быть ручкой динамических данных заменять [DDE] приложение сервера.) Этот элемент установлен в возврате. Величины Ошибки могут быть одно из следующего:

Оцените Значение Файла SE_ERR_FNF не обнаружившее, что Путь SE_ERR_PNF не обнаруживал Доступ SE_ERR_ACCESSDENIED запрещал SE_ERR_OOM Из библиотеки памяти SE_ERR_DLLNOTFOUND Динамической связи не обнаружившее SE_ERR_SHARE Не может распространить открытую информацию ассоциации файлового Файла SE_ERR_ASSOCINCOMPLETE не полная операция SE_ERR_DDETIMEOUT DDE синхронизированная операция SE_ERR_DDEFAIL DDE потерпевшую неудачу операцию SE_ERR_DDEBUSY DDE занятой ассоциации Файла SE_ERR_NOASSOC не доступный


lpIDList

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

lpClass

Указатель в недействительный расторгнутую строку, определяющую имя файлового класса или глобально уникальный идентификатор (GUID). Проигнорированное если fMask не установлен на SEE_MASK_CLASSNAME.

hkeyClass

Прооперируйте клавишу регистрации для файлового класса. Проигнорированное если fMask не установлен на SEE_MASK_CLASSKEY.

dwHotKey

Горячая клавиша, чтобы соединяться с приложением. Младшее слово является виртуальным-ключевым кодом, и старшее слово является флагом модификатора (HOTKEYF_). Для списка флагов модификатора, смотри описание сообщения WM_SETHOTKEY. Проигнорированное если fMask не установлен на SEE_MASK_HOTKEY.

hIcon

Прооперируйте иконку для файлового класса. Проигнорированное если fMask не установлен на SEE_MASK_ICON.

hProcess

Прооперируйте вновь начатое приложение. Этот элемент установлен в возврате и всегда НЕДЕЙСТВИТЕЛЕН если fMask не установлен на SEE_MASK_NOCLOSEPROCESS.



Смотри Также

ITEMIDLIST, ShellExecuteEx, ShowWindow, WM_SETHOTKEY


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz