Método Shell.ShellExecute

Realiza una operación especificada en un archivo especificado.

Sintaxis

Jscript:

iRetVal = Shell.ShellExecute(
  sFile,
  [ vArguments ],
  [ vDirectory ],
  [ vOperation ],
  [ vShow ]
);

Vbscript:

iRetVal = Shell.ShellExecute( _
  sFile, _
  [ ByVal vArguments ], _
  [ ByVal vDirectory ], _
  [ ByVal vOperation ], _
  [ ByVal vShow ] _
)

VB:

Shell.ShellExecute( _
  ByVal sFile As BSTR, _
  [ ByVal vArguments As Variant ], _
  [ ByVal vDirectory As Variant ], _
  [ ByVal vOperation As Variant ], _
  [ ByVal vShow As Variant ] _
) As Integer

Parámetros

sFile [in]

Tipo: BSTR

Cadena que contiene el nombre del archivo en el que ShellExecute realizará la acción especificada por vOperation.

vArguments [in, optional]

Tipo: Variant

Cadena que contiene valores de parámetro para la operación.

vDirectory [in, optional]

Tipo: Variant

Ruta de acceso completa del directorio que contiene el archivo especificado por sFile. Si no se especifica este parámetro, se usa el directorio de trabajo actual.

vOperation [in, optional]

Tipo: Variant

La operación que se va a realizar. Este valor se establece en una de las cadenas de verbo admitidas por el archivo. Para obtener una explicación de los verbos, vea la sección Comentarios. Si no se especifica este parámetro, se realiza la operación predeterminada.

vShow [in, optional]

Tipo: Variant

Una recomendación sobre cómo se debe mostrar inicialmente la ventana de la aplicación. La aplicación puede omitir esta recomendación. Este parámetro puede ser uno de los valores siguientes. Si no se especifica este parámetro, la aplicación usa su valor predeterminado.

Valor	Significado
0	Abra la aplicación con una ventana oculta.
1	Abra la aplicación con una ventana normal. Si la ventana está minimizada o maximizada, el sistema lo restaura a su tamaño y posición originales.
2	Abra la aplicación con una ventana minimizada.
3	Abra la aplicación con una ventana maximizada.
4	Abra la aplicación con su ventana en su tamaño y posición más recientes. La ventana activa permanece activa.
5	Abra la aplicación con su ventana en su tamaño y posición actuales.
7	Abra la aplicación con una ventana minimizada. La ventana activa permanece activa.
10	Abra la aplicación con su ventana en el estado predeterminado especificado por la aplicación.

 

Comentarios

Este método equivale a iniciar uno de los comandos asociados al menú contextual de un archivo. Cada comando se representa mediante una cadena de verbo. El conjunto de verbos admitidos varía de archivo a archivo. El verbo más comúnmente admitido es "open", que suele ser el verbo predeterminado. Otros verbos pueden ser compatibles solo con determinados tipos de archivos. Para obtener más información sobre los verbos de Shell, consulte Inicio de aplicaciones o Extensión de menús contextuales.

Este método no está disponible actualmente en Microsoft Visual Basic.

Ejemplos

En los ejemplos siguientes se muestra el uso de ShellExecute para abrir el Bloc de notas. El uso se muestra para JScript y VBScript.

Jscript:

function ShellExecuteJS()
{
    var objShell = new ActiveXObject("Shell.Application");
    objShell.ShellExecute("notepad.exe", "", "", "open", 1);
}

Vbscript:

Function ShellExecuteVB()
    Dim objShell
    Set objShell = CreateObject("Shell.Application")
    Call objShell.ShellExecute("notepad.exe", "", "", "open", 1)
End Function

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado	Shldisp.h
IDL	Shldisp.idl
Archivo DLL	Shell32.dll (versión 5.0 o posterior)