Compartilhar via


Método IFileOperationProgressSink::P reMoveItem (shobjidl_core.h)

Executa ações implementadas pelo chamador antes do processo de movimentação para cada item começar.

Sintaxe

HRESULT PreMoveItem(
  [in] DWORD      dwFlags,
  [in] IShellItem *psiItem,
  [in] IShellItem *psiDestinationFolder,
  [in] LPCWSTR    pszNewName
);

Parâmetros

[in] dwFlags

Tipo: DWORD

valor bit a bit que contém sinalizadores que controlam a operação. Consulte TRANSFER_SOURCE_FLAGS para obter descrições de sinalizador.

[in] psiItem

Tipo: IShellItem*

Ponteiro para um IShellItem que especifica o item a ser movido.

[in] psiDestinationFolder

Tipo: IShellItem*

Ponteiro para um IShellItem que especifica a pasta de destino para conter o item movido.

[in] pszNewName

Tipo: LPCWSTR

Ponteiro para um novo nome para o item em seu novo local. Essa é uma cadeia de caracteres Unicode terminada em nulo e pode ser NULL. Se NULL, o nome do item de destino será o mesmo que a origem.

Retornar valor

Tipo: HRESULT

Retorna S_OK se tiver êxito; caso contrário, um valor de erro. No caso de um valor de erro, a operação de movimentação e todas as operações subsequentes pendentes da chamada para IFileOperation são canceladas.

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)