shellExec

Syntax

int shellExec(string verb, string filename, string params, string defaultdir)

Arguments

verb

is the shell operation to be performed (e.g., "open", "print", or "explore").

filename

the name of the file to be operated upon; it may be an executable file, a document file, or a URL.

params

specifies any parameters to be passed to the application.

defaultdir

specifies the default directory for the execution of the command.

Return

-1 if the operation is successful, or an integer error code otherwise.

Description

Lets your filter execute a Windows shell command. shellExec is useful if you want to run an external program, or to load a webpage.

Example

// The following call will open file help.html from
// the filter's installation directory using the default web browser:
shellExec("open", "help.html", NULL, filterInstallDir);

Also see

getWindowsVersion

Comments

Any unneeded parameter may be set to NULL. If NULL is specified for "Verb", the function opens the file or URL specified by "Filename".