estrutura FILEPATHS_A (setupapi.h)

Artigo
11/20/2024

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 Notifications.

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 de 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, será NO_ERROR.

Flags

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

Para SPFILENOTIFY_COPYERROR notificações, Sinalizadores 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 navegar.
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 seguintes valores.

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.

Observações

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

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

Consulte também

Visão geral

estruturas

Compartilhar via