Compartir a través de

Función SHOpenFolderAndSelectItems (shlobj_core.h)

  • Artículo

Abre una ventana del Explorador de Windows con los elementos especificados en una carpeta determinada seleccionada.

Sintaxis

SHSTDAPI SHOpenFolderAndSelectItems(
  [in]           PCIDLIST_ABSOLUTE     pidlFolder,
                 UINT                  cidl,
  [in, optional] PCUITEMID_CHILD_ARRAY apidl,
                 DWORD                 dwFlags
);

Parámetros

[in] pidlFolder

Tipo: PCIDLIST_ABSOLUTE

Puntero a una lista de identificadores de elemento completo que especifica la carpeta.

cidl

Tipo: UINT

Recuento de elementos de la matriz de selección, apidl. Si cidl es cero, pidlFolder debe apuntar a un ITEMIDLIST completamente especificado que describa un único elemento que se va a seleccionar. Esta función abre la carpeta primaria y selecciona ese elemento.

[in, optional] apidl

Tipo: PCUITEMID_CHILD_ARRAY

Puntero a una matriz de estructuras PIDL, cada una de las cuales es un elemento que se va a seleccionar en la carpeta de destino a la que hace referencia pidlFolder.

dwFlags

Tipo: DWORD

Marcas opcionales. En Windows XP, este parámetro se omite. En Windows Vista, se definen las marcas siguientes.

OFASI_EDIT (0x0001)

Seleccione un elemento y coloque su nombre en modo de edición. Esta marca solo se puede usar cuando se selecciona un solo elemento. En el caso de varias selecciones de elementos, se omite.

OFASI_OPENDESKTOP (0x0002)

Seleccione el elemento o los elementos en el escritorio en lugar de en una ventana del Explorador de Windows. Tenga en cuenta que si el escritorio está oculto detrás de ventanas abiertas, no se hará visible.

Valor devuelto

Tipo: HRESULT

Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Se debe llamar a CoInitialize o CoInitializeEx antes de usar SHOpenFolderAndSelectItems. Si no lo hace, se producirá un error en SHOpenFolderAndSelectItems .

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shlobj_core.h (incluya Shlobj.h)
Library Shell32.lib
Archivo DLL Shell32.dll (versión 6.0 o posterior)