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 |