SHFILEOPSTRUCT

9/9/2008

Essa estrutura contém informações que o SHFileOperation função usa para executar operações arquivo.

Syntax

typedef struct _SHFILEOPSTRUCT {
  HWND hwnd;
  UINT wFunc;
  LPCWSTR pFrom;
  LPCWSTR pTo;
  FILEOP_FLAGS fFlags;
  BOOL fAnyOperationsAborted;
  LPVOID hNameMappings;
  LPCWSTR lpszProgressTitle;
} SHFILEOPSTRUCT, *LPSHFILEOPSTRUCT;

Os membros

• hwnd
  Identificador janela para caixa de diálogo para exibir informações sobre o status da operação do arquivo.

• wFunc
  Valor que indica qual operação para executar. A seguinte tabela mostra os valores possíveis.

  Valor	Descrição
  FO_COPY	Copia os arquivos especificados na pFrom membro para a localidade especificada na pTo membro.
  FO_DELETE	Exclui os arquivos especificados na pFrom.
  FO_MOVE	Move os arquivos especificados na pFrom para a localidade especificada na pTo.
  FO_RENAME	Renomeia o arquivo especificado no pFrom. Não é possível usar esse sinalizador para renomear múltiplo arquivos com uma única função chamar. Use FO_MOVE.

• pFrom
  Endereço de uma reserva para especificar um ou mais nomes arquivo de origem. Esses nomes devem ser caminhos totalmente qualificado. Standard Microsoft® MS-DOS® curingas, como " * ", são permitidos na posição nome de arquivo. Embora esse membro é declarado como um seqüência de caracteres NULL-Terminated, ele é usado como uma reserva para armazenar múltiplo nomes arquivo. Cada nome arquivo deve ser terminado por uma única NULL caractere. Um adicionais NULL caractere deve ser acrescentado ao final do nome final para indicar o final do pFrom.

• pTo
  Endereço de uma reserva para conter o nome do arquivo de destino ou Diretório. Este parâmetro deve ser definido como NULL se ele não for usado. Como pFrom, o pTo membro é também um duplo - NULL terminada seqüência de caracteres e é tratada em grande parte da mesma maneira. No entanto, pTo deve atender a seguinte especificações:

  • Caracteres curinga não são com suporte.
  • Copiar e mover as operações podem especificar diretórios destino que não existem e o sistema tenta criá-los. O sistema normalmente exibe uma caixa diálogo solicitar o usuário se elas desejar para criar o novo Diretório. Para suprimir esta caixa diálogo e ter os diretórios criados silenciosamente, defina o sinalizador FOF_NOCONFIRMMKDIR em fFlags.
  • Para as operações de cópia e movimentação, a reserva pode conter múltiplo arquivo de destino nomes se a fFlags membro especifica FOF_MULTIDESTFILES.
  • Pacote múltiplo nomes para o seqüência de caracteres da mesma maneira como para pFrom.
  • Use apenas caminhos totalmente qualificado. Uso relativo caminhos ter resultados imprevisíveis.

• fFlags
  Sinaliza que controle a operação do arquivo. A seguinte tabela mostra os valores possíveis.

  Sinalizador	Descrição
  FOF_ALLOWUNDO	Preserve informações de recuperação, se possível. Se pFrom Não Contém caminho totalmente qualificado e nomes arquivo, este sinalizador será ignorado.
  FOF_FILESONLY	Não suportado.
  FOF_MULTIDESTFILES	Não suportado.
  FOF_NO_CONNECTED_ELEMENTS	Não suportado.
  FOF_NOCONFIRMATION	Responder com "Sim para tudo" Para qualquer caixa diálogo que é exibida.
  FOF_NOCONFIRMMKDIR	Não confirme a criação de um novo Diretório se a operação requer um para ser criado.
  FOF_NOCOPYSECURITYATTRIBS	Não suportado.
  FOF_NOERRORUI	Fazer não exibir um interface do usuário se ocorrer um erro.
  FOF_NORECURSION	Não suportado.
  FOF_RENAMEONCOLLISION	Fornecer o arquivo sendo operado em um novo nome em um mover, copiar ou renomear operação se já existir um arquivo com nome de destino.
  FOF_SILENT	Fazer não exibir uma caixa diálogo de progresso.
  FOF_SIMPLEPROGRESS	Exibir uma caixa diálogo de andamento, mas não apresentação nomes de arquivo.
  FOF_WANTMAPPINGHANDLE	Não suportado.
  FOF_WANTNUKEWARNING	Não suportado.

• fAnyOperationsAborted
  Não suportado.

• hNameMappings
  Não suportado.

• lpszProgressTitle
  Endereço de uma seqüência de caracteres para usar como o título de uma caixa diálogo de progresso. Esse membro é usado somente se fFlags Inclui o sinalizador FOF_SIMPLEPROGRESS.

Remarks

Se pFrom está definido para um nome arquivo, excluir o arquivo com FO_DELETE não mover para o Lixeira, mesmo se o sinalizador FOF_ALLOWUNDO for definida. Você deve usar um caminho completo.

Requirements

Header	shellapi.h
Windows Embedded CE	Windows CE .NET 4.2 and later

See Also

Reference

Standard Shell Structures
SHFileOperation