Funzione SetupCopyErrorW (setupapi.h)
[Questa funzione è disponibile per l'uso nei sistemi operativi indicati nella sezione Requisiti. È possibile che in versioni successive sia stata modificata o non sia più disponibile. SetupAPI non deve più essere usato per l'installazione di applicazioni. Usare invece Windows Installer per lo sviluppo di programmi di installazione di applicazioni. SetupAPI continua a essere usato per l'installazione dei driver di dispositivo.
La funzione SetupCopyError genera una finestra di dialogo per notificare a un utente un errore di copia del file.
Sintassi
WINSETUPAPI UINT SetupCopyErrorW(
[in] HWND hwndParent,
[in] PCWSTR DialogTitle,
[in] PCWSTR DiskName,
[in] PCWSTR PathToSource,
[in] PCWSTR SourceFile,
[in] PCWSTR TargetPathFile,
[out] UINT Win32ErrorCode,
[in] DWORD Style,
[in, out] PWSTR PathBuffer,
[in] DWORD PathBufferSize,
[in, out] PDWORD PathRequiredSize
);
Parametri
[in] hwndParent
Handle della finestra padre per questa finestra di dialogo.
[in] DialogTitle
Puntatore facoltativo a una stringa con terminazione null che specifica il titolo della finestra di dialogo.
Questo parametro può essere NULL. Se questo parametro è NULL, viene usato il titolo predefinito "Copia errore" (localizzato nel linguaggio di sistema).
[in] DiskName
Puntatore facoltativo a una stringa con terminazione null che specifica il nome del disco da inserire.
Questo parametro può essere NULL. Se questo parametro è NULL, viene usato il nome predefinito "(Sconosciuto)" (localizzato nel linguaggio di sistema).
[in] PathToSource
Puntatore al componente percorso del file di origine in cui un'operazione ha esito negativo, ad esempio F:\x86.
Usare una stringa con terminazione null.
[in] SourceFile
Puntatore a una stringa con terminazione null che specifica la parte del nome file del file in cui un'operazione ha esito negativo.
Usare una stringa con terminazione null. Questo nome file viene visualizzato se l'utente fa clic sui pulsanti Dettagli o Sfoglia . La funzione SetupCopyError cerca il file che usa i nomi dei moduli compressi. Pertanto, è possibile passare cmd.exe e non preoccuparsi che il file esista effettivamente come cmd.ex_ nel supporto di origine.
[in] TargetPathFile
Puntatore facoltativo a una stringa con terminazione null che specifica il percorso completo del file di destinazione per le operazioni di ridenominazione e copia.
Usare una stringa con terminazione null. Questo parametro può essere NULL. Se TargetPathFile non è specificato, viene usato "(Sconosciuto)" (localizzato nel linguaggio di sistema).
[out] Win32ErrorCode
Se si verifica un errore, questo membro è il codice errore di sistema.
Se non si verifica un errore, è NO_ERROR.
[in] Style
Flag che controllano la formattazione e il comportamento di una finestra di dialogo.
Questo parametro può essere uno dei flag seguenti.
IDF_NOBROWSE
Non visualizzare l'opzione sfoglia.
IDF_NOSKIP
Non visualizzare l'opzione ignora file.
IDF_NODETAILS
Non visualizzare l'opzione dettagli.
Se questo flag è impostato, è possibile omettere i parametri TargetPathFile e Win32ErrorCode .
IDF_NOCOMPRESSED
Non controllare le versioni compresse del file di origine.
IDF_OEMDISK
L'origine dell'operazione è un disco fornito da un produttore hardware.
IDF_NOBEEP
Impedisce il beping della finestra di dialogo per ottenere l'attenzione dell'utente quando viene visualizzato per la prima volta.
IDF_NOFOREGROUND
Impedisce alla finestra di dialogo di diventare la finestra in primo piano.
IDF_WARNIFSKIP
Avvisa l'utente che ignora un file può influire sull'installazione.
[in, out] PathBuffer
Puntatore facoltativo a una variabile in cui questa funzione restituisce il percorso (non incluso il nome file) del percorso specificato da un utente nella finestra di dialogo. È consigliabile usare una stringa con terminazione Null.
La stringa con terminazione null non deve superare le dimensioni del buffer di destinazione. Per evitare errori di buffer insufficienti, PathBuffer deve essere almeno MAX_PATH. Per altre informazioni, vedere la sezione Osservazioni di questo argomento.
[in] PathBufferSize
Dimensioni del buffer a cui PathBuffer punta, in caratteri.
Le dimensioni del buffer devono essere almeno MAX_PATH caratteri, incluso il terminatore Null .
[in, out] PathRequiredSize
Puntatore facoltativo a una variabile in cui questa funzione restituisce le dimensioni del buffer necessarie, in caratteri, incluso il terminatore Null .
Valore restituito
La funzione restituisce uno dei valori seguenti.
Per informazioni dettagliate sull'errore, chiamare GetLastError.
Commenti
Se questa funzione viene chiamata con pathBuffer di NULL e pathBufferSize pari a 0 (zero), la funzione inserisce le dimensioni del buffer necessarie per contenere i dati specificati nella variabile a cui punta PathRequiredSize.
Se la funzione ha esito positivo, il valore restituito è NO_ERROR. In caso contrario, il valore restituito è uno dei valori specificati.
Per evitare errori di buffer insufficienti, ReturnBuffer deve essere almeno MAX_PATH.
Nota
L'intestazione setupapi.h definisce SetupCopyError come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | setupapi.h |
| Libreria | Setupapi.lib |
| DLL | Setupapi.dll |