Método IFileOperation::SetOperationFlags (shobjidl_core.h)
Define parâmetros para a operação atual.
HRESULT SetOperationFlags(
[in] DWORD dwOperationFlags
);
[in] dwOperationFlags
Tipo: DWORD
Sinalizadores que controlam a operação de arquivo. Esse membro pode ser uma combinação dos sinalizadores a seguir. Os sinalizadores FOF são definidos em Shellapi.h e os sinalizadores FOFX são definidos em Shobjidl.h.
Preservar informações de desfazer, se possível.
Antes do Windows Vista, as operações só podiam ser desfeitas do mesmo processo que executava a operação original.
No Windows Vista e em sistemas posteriores, o escopo do desfazer é uma sessão do usuário. Qualquer processo em execução na sessão do usuário pode desfazer outra operação. O estado de desfazer é mantido no processo de Explorer.exe e, enquanto esse processo estiver em execução, ele poderá coordenar as funções desfazer.
Se o parâmetro de arquivo de origem não contiver nomes de arquivo e caminho totalmente qualificados, esse sinalizador será ignorado.
Execute a operação somente em arquivos (não em pastas) se um nome de arquivo curinga (.) for especificado.
Responda com Sim a Todos para qualquer caixa de diálogo exibida.
Não confirme a criação de uma nova pasta se a operação exigir que uma seja criada.
Não mova itens conectados como um grupo. Mova apenas os arquivos especificados.
Não copie os atributos de segurança do item.
Não exiba uma mensagem para o usuário se ocorrer um erro. Se esse sinalizador for definido sem FOFX_EARLYFAILURE, qualquer erro será tratado como se o usuário tivesse escolhido Ignorar ou Continuar em uma caixa de diálogo. Ele interrompe a ação atual, define um sinalizador para indicar que uma ação foi anulada e prossegue com o restante da operação.
Operar somente na pasta local. Não opere recursivamente em subdiretórios.
Dê ao item que está sendo operado um novo nome em uma operação de movimentação, cópia ou renomeação se já existir um item com o nome de destino.
Não exiba uma caixa de diálogo de progresso.
Envie um aviso se um arquivo ou pasta estiver sendo destruído durante uma operação de exclusão em vez de reciclado. Esse sinalizador substitui parcialmente FOF_NOCONFIRMATION.
Introduzido no Windows 8. A operação de arquivo foi invocada pelo usuário e deve ser colocada na pilha de desfazer. Esse sinalizador é preferencial para FOF_ALLOWUNDO.
Entre nas junções de namespace do Shell. Por padrão, as junções não são inseridas. Para obter mais informações sobre junções, consulte Especificando o local de uma extensão de namespace.
Se possível, crie um link rígido em vez de uma nova instância do arquivo no destino.
Se uma operação exigir direitos elevados e o sinalizador FOF_NOERRORUI estiver definido para desabilitar a interface do usuário do erro, exiba um prompt de interface do usuário do UAC, no entanto.
Se FOFX_EARLYFAILURE for definido junto com FOF_NOERRORUI, todo o conjunto de operações será interrompido ao encontrar qualquer erro em qualquer operação. Esse sinalizador é válido somente quando FOF_NOERRORUI está definido.
Renomeie colisões de maneira a preservar extensões de nome de arquivo. Esse sinalizador é válido somente quando FOF_RENAMEONCOLLISION também está definido.
Mantenha o arquivo ou pasta mais recente, com base na propriedade Date Modified, se ocorrer uma colisão. Isso é feito automaticamente sem nenhuma interface do usuário de prompt apresentada ao usuário.
Não use ganchos de cópia.
Não permita que a caixa de diálogo de progresso seja minimizada.
Copie os atributos de segurança do item de origem para o item de destino ao executar uma operação de movimentação entre volumes. Sem esse sinalizador, o item de destino recebe os atributos de segurança de sua nova pasta.
Não exiba o caminho do item de origem na caixa de diálogo de progresso.
Não exiba o caminho do item de destino na caixa de diálogo de progresso.
Introduzido no Windows 8. Quando um arquivo é excluído, envie-o para a Lixeira em vez de excluí-lo permanentemente.
Introduzido no Windows Vista SP1. O usuário espera um requisito de elevação de direitos, portanto, não exiba uma caixa de diálogo solicitando uma confirmação da elevação.
Introduzido no Windows 7. Exiba um Download em vez de Copiar mensagem na caixa de diálogo em andamento.
Introduzido no Windows 7. Não exiba a linha de localização na caixa de diálogo de progresso.
Tipo: HRESULT
Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.
Defina esses sinalizadores antes de chamar IFileOperation::P erformOperations para definir os parâmetros para todas as operações que estão sendo executadas, como copiar, excluir ou renomear.
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Windows Vista, Windows 7 [somente aplicativos da área de trabalho] |
Servidor mínimo com suporte | Windows Server 2008 R2 [somente aplicativos da área de trabalho] |
Plataforma de Destino | Windows |
Cabeçalho | shobjidl_core.h (inclua Shobjidl.h) |