Método ITransferSource::OpenItem (shobjidl_core.h)

  • Artículo

Abre el elemento para copiarlo. Devuelve un objeto que se puede enumerar para los recursos (IShellItemResources).

Sintaxis

HRESULT OpenItem(
  [in]  IShellItem            *psi,
  [in]  TRANSFER_SOURCE_FLAGS flags,
  [out] REFIID                riid,
  [out] void                  **ppv
);

Parámetros

[in] psi

Tipo: IShellItem*

Puntero al IShellItem que se va a abrir.

[in] flags

Tipo: TRANSFER_SOURCE_FLAGS

Marcas que controlan la operación de archivo. Una o varias de las constantes de TRANSFER_SOURCE_FLAGS .

[out] riid

Tipo: REFIID

Referencia al IID (identificador de interfaz o GUID) de la interfaz que se va a devolver en ppv. Debe ser un IShellItemResources o una interfaz derivada de IShellItemResources.

[out] ppv

Tipo: void**

Cuando este método vuelve, contiene la dirección de un puntero a la interfaz especificada por riid.

Valor devuelto

Tipo: HRESULT

Devuelve S_OK si se ejecuta correctamente, o uno de los siguientes códigos de Shell específicos o un código de error del sistema.

Código devuelto Descripción
COPYENGINE_S_YES
 El usuario respondió "Sí" al cuadro de diálogo.
COPYENGINE_S_USER_RETRY
 El usuario respondió para reintentar la acción actual.
COPYENGINE_S_USER_IGNORED
 El usuario respondió "No" al cuadro de diálogo.
COPYENGINE_S_MERGE
 El usuario respondió a las carpetas de combinación.
COPYENGINE_S_USER_RETRY_WITH_NEW_NAME
 El usuario respondió para reintentar el archivo con el nuevo nombre.
COPYENGINE_S_DONT_PROCESS_CHILDREN
 No se deben procesar los elementos secundarios.
COPYENGINE_S_PENDING
 El error se ha puesto en cola y se mostrará más adelante.
COPYENGINE_E_USER_CANCELLED
 El usuario canceló la acción actual.
COPYENGINE_E_REQUIRES_ELEVATION
 La operación requiere privilegios elevados.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shobjidl_core.h (include Shobjidl.h)