|
Overview |
|
|
|
Group |
|
|
|
Quick Info
Windows NT
| Yes
| Win95
| Yes
| Win32s
| No
| Import Library
| -
| Header File
| shellapi.h
| Unicode
| WinNT
| Platform Notes
| None
|
|
|
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
| Last news from Greatis Software |
 |
|
Nostalgia .Net |
|
.Net is powerful, but not all-powerful, so sometimes we need to use Win32 API for our .Net applications. It's simple enough with Platform Invoke if you have Win32 skill, but we do not always have time to dig the ancient documentation, declare the special types that are compatible with Win32, find the values of the Win32's constants and so on. Nostalgia .Net offers several simple-to-use classes, and components that will allow you to forget about the headache of Win32 and just use the power of Win32 in your application the same way as you use the native. Net classes. More » |
| Recommended software for developers |
 |
|
Ultimate Pack |
|
Component pack for Delphi and C++ Builder that contains runtime form designer, runtime object inspector, print suite and much more for the very special price. More » |
 |
|
Form Designer .Net |
|
Unique runtime form design solution that allows to edit any form in .Net WinForms application at runtime with full source codes for only 300 euro! More » |
 |
|
Print Suite .Net |
|
Print Suite .Net is a set of components for easy printing texts, images and grids from your WinForms applications. Full C# source codes are available More » |
 |
|
Gradient Controls .Net |
|
Gradient Controls .Net offers controls with gradient background feature. Labels, panels and so on... Full C# source codes are available More » |
 |
|
Greatis iGrid |
|
iGrid plots drawing grid right over your desktop, so you can use it everywhere, with any drawing application without any special plugins for different graphic editors. More » |
All the contacts and projectsDmitry Vasiliev (just.dmitry)
Related LinksSoftware for Visual Studio .NET developers
Software for Delphi and C++ Builder developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET More Online Helps Win32 Programmer's Reference
Win32 Multimedia Programmer's Reference
OLE Programmer's Reference
Microsoft Windows Pen API Programmer's Reference
Microsoft Windows Sockets 2 Reference
Microsoft Windows Telephony API (TAPI) Programmer's Reference
Unix Manual Pages
|
