ShellExecuteEx

[Now Supported on Windows NT]

The ShellExecuteEx function performs an action on a file. The file can be an executable file or a document.

WINSHELLAPI BOOL WINAPI ShellExecuteEx(

LPSHELLEXECUTEINFO lpExecInfo // pointer to SHELLEXECUTEINFO structure
);  

Parameters

lpExecInfo

Pointer to a SHELLEXECUTEINFO structure that contains and receives information about the application to start.

Return Values

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

If the function succeeds, it sets the hInstApp member of the SHELLEXECUTEINFO structure to the instance handle of the application that the function started. If the function fails, hInstApp is one of the SE_ERR_ error values indicating the cause of the failure. (An instance handle will always be greater than 32, and an error value less than 32.) Note that the SE_ERR_ error values are for compatibility with the ShellExecute function; use the GetLastError function to retrieve error information.

Last error values returned by GetLastError correspond to the SE_ERR_ values and may be one of the following:

Value Meaning
ERROR_FILE_NOT_FOUND The specified file was not found.
ERROR_PATH_NOT_FOUND The specified path was not found.
ERROR_DDE_FAIL The DDE transaction failed.
ERROR_NO_ASSOCIATION There is no application associated with the given filename extension.
ERROR_ACCESS_DENIED  
ERROR_DLL_NOT_FOUND  
ERROR_CANCELLED The function prompted the user for the location of the application, but the user cancelled the request.
ERROR_NOT_ENOUGH_MEMORY  
ERROR_SHARING_VIOLATION A sharing violation occurred.

See Also

ShellExecute, SHELLEXECUTEINFO