struttura FILEPATHS_A (setupapi.h)

  • Articolo

La struttura FILEPATHS archivia le informazioni sul percorso di origine e di destinazione. Le funzioni di installazione inviano la struttura FILEPATHS come parametro in diverse notifiche inviate alle routine di callback. Per altre informazioni, vedere Notifiche.

Sintassi

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

Members

Target

Percorso del file di destinazione.

Source

Percorso del file di origine. Questo membro non viene utilizzato quando la struttura FILEPATHS viene utilizzata con un'operazione di eliminazione file.

Win32Error

Se si verifica un errore, questo membro è il codice di errore di sistema. Se non si è verificato alcun errore, viene NO_ERROR.

Flags

Informazioni aggiuntive che dipendono dalla notifica inviata con la struttura FILEPATHS .

Per le notifiche di SPFILENOTIFY_COPYERROR , Flags specifica il comportamento della finestra di dialogo e può essere uno dei valori seguenti.

Valore Significato
SP_COPY_NOBROWSE
 Non offrire all'utente l'opzione di esplorazione.
SP_COPY_NOSKIP
 Non offrire all'utente l'opzione per ignorare il file.
SP_COPY_WARNIFSKIP
 Informare l'utente che l'omissione del file può influire sull'installazione.
 

Per le notifiche di SPFILENOTIFY_FILEOPDELAYED , Flags specifica il tipo di operazione file ritardata e può essere uno dei valori seguenti.

Valore Significato
FILEOP_COPY
 Un'operazione di copia file è stata ritardata.
FILEOP_DELETE
 Un'operazione di eliminazione file è stata ritardata.

Commenti

Nota

L'intestazione setupapi.h definisce FILEPATHS come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Intestazione setupapi.h

Vedi anche

Panoramica

Strutture