Método ITransferAdviseSink::ConfirmOverwrite (shobjidl_core.h)

Artigo
08/26/2023

Exibe uma mensagem para o usuário confirmando que a substituição de itens existentes é aceitável.

Sintaxe

HRESULT ConfirmOverwrite(
  IShellItem *psiSource,
  IShellItem *psiDestParent,
  LPCWSTR    pszName
);

Parâmetros

psiSource

Tipo: IShellItem*

Um ponteiro para o IShellItem de origem.

psiDestParent

Tipo: IShellItem*

Um ponteiro para a pasta pai de destino IShellItem.

pszName

Tipo: LPCWSTR

Um ponteiro para uma cadeia de caracteres larga que contém o nome desejado do item no destino. Se FOR NULL, o nome será o mesmo que o item shell apontado pelo psiSource.

Valor retornado

Tipo: HRESULT

Os valores retornados listados abaixo são emitidos especificamente por esse método para informar o processo de chamada de como a operação terminou. Se outros resultados ou erros forem emitidos durante a operação desse método, eles deverão ser retornados ao processo de chamada.

Código de retorno	Descrição
COPYENGINE_S_USER_IGNORED	O usuário clicou em Ignorar. Permite que o processo de chamada continue processando outros arquivos conforme apropriado.
COPYENGINE_E_USER_CANCELLED	O usuário clicou em Cancelar. Interrompe o processamento do documento atual e encerra o processo atual.

Requisitos


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)