estrutura FILEPATHS_A (setupapi.h)

  • Artigo

A estrutura FILEPATHS armazena informações de caminho de origem e de destino. As funções de instalação enviam a estrutura FILEPATHS como um parâmetro em várias das notificações enviadas para rotinas de retorno de chamada. Para obter mais informações, consulte Notificações.

Sintaxe

typedef struct _FILEPATHS_A {
  PCSTR Target;
  PCSTR Source;
  UINT  Win32Error;
  DWORD Flags;
} FILEPATHS_A, *PFILEPATHS_A;

Membros

Target

Caminho para o arquivo de destino.

Source

Caminho para o arquivo de origem. Esse membro não é usado quando a estrutura FILEPATHS é usada com uma operação de exclusão de arquivo.

Win32Error

Se ocorrer um erro, esse membro será o código de erro do sistema. Se nenhum erro tiver ocorrido, ele será NO_ERROR.

Flags

Informações adicionais que dependem da notificação enviada com a estrutura FILEPATHS .

Para SPFILENOTIFY_COPYERROR notificações, Flags especifica o comportamento da caixa de diálogo e pode ser um dos valores a seguir.

Valor Significado
SP_COPY_NOBROWSE
 Não ofereça ao usuário a opção de procurar.
SP_COPY_NOSKIP
 Não ofereça ao usuário a opção de ignorar o arquivo.
SP_COPY_WARNIFSKIP
 Informe ao usuário que ignorar o arquivo pode afetar a instalação.
 

Para SPFILENOTIFY_FILEOPDELAYED notificações, Flags especifica o tipo de operação de arquivo atrasada e pode ser um dos valores a seguir.

Valor Significado
FILEOP_COPY
 Uma operação de cópia de arquivo foi atrasada.
FILEOP_DELETE
 Uma operação de exclusão de arquivo foi atrasada.

Comentários

Observação

O cabeçalho setupapi.h define FILEPATHS como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho setupapi.h

Confira também

Visão geral

Estruturas