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

  • Artigo

Abre o item para cópia. Retorna um objeto que pode ser enumerado para recursos (IShellItemResources).

Sintaxe

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

Parâmetros

[in] psi

Tipo: IShellItem*

Um ponteiro para o IShellItem a ser aberto.

[in] flags

Tipo: TRANSFER_SOURCE_FLAGS

Os sinalizadores que controlam a operação de arquivo. Uma ou mais das constantes TRANSFER_SOURCE_FLAGS .

[out] riid

Tipo: REFIID

Uma referência ao IID (a ID da interface ou GUID) da interface a ser retornada em ppv. Deve ser um IShellItemResources ou uma interface derivada de IShellItemResources.

[out] ppv

Tipo: void**

Quando esse método retorna, contém o endereço de um ponteiro para a interface especificada por riid.

Retornar valor

Tipo: HRESULT

Retorna S_OK se tiver êxito ou um dos seguintes códigos de Shell específicos ou um código de erro do sistema.

Código de retorno Descrição
COPYENGINE_S_YES
 O usuário respondeu "Sim" à caixa de diálogo.
COPYENGINE_S_USER_RETRY
 O usuário respondeu para repetir a ação atual.
COPYENGINE_S_USER_IGNORED
 O usuário respondeu "Não" à caixa de diálogo.
COPYENGINE_S_MERGE
 O usuário respondeu às pastas de mesclagem.
COPYENGINE_S_USER_RETRY_WITH_NEW_NAME
 O usuário respondeu para repetir o arquivo com o novo nome.
COPYENGINE_S_DONT_PROCESS_CHILDREN
 Itens filho não devem ser processados.
COPYENGINE_S_PENDING
 O erro foi enfileirado e será exibido posteriormente.
COPYENGINE_E_USER_CANCELLED
 O usuário cancelou a ação atual.
COPYENGINE_E_REQUIRES_ELEVATION
 A operação requer privilégios elevados.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shobjidl_core.h (inclua Shobjidl.h)