Funzione SetupPromptForDiskW (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 SetupPromptForDisk visualizza una finestra di dialogo che richiede all'utente di un disco.
Sintassi
WINSETUPAPI UINT SetupPromptForDiskW(
[in] HWND hwndParent,
[in] PCWSTR DialogTitle,
[in] PCWSTR DiskName,
[in] PCWSTR PathToSource,
[in] PCWSTR FileSought,
[in] PCWSTR TagFile,
[in] DWORD DiskPromptStyle,
[in, out] PWSTR PathBuffer,
[in] DWORD PathBufferSize,
[in, out] PDWORD PathRequiredSize
);
Parametri
[in] hwndParent
Gestire la finestra padre per questa finestra di dialogo.
[in] DialogTitle
Puntatore facoltativo a una stringa con terminazione null specificando il titolo della finestra di dialogo. Se questo parametro è NULL, viene usato il valore predefinito "%s-Files Needed"" (localizzato). Il valore "%s" viene sostituito con il testo recuperato dalla finestra padre. Se non viene recuperato alcun testo dalla finestra padre, il titolo è "File necessari".
[in] DiskName
Puntatore facoltativo a una stringa con terminazione null specificando il nome del disco da inserire. Se questo parametro è NULL, viene usato il valore predefinito "(Unknown)" (localizzato).
[in] PathToSource
Puntatore facoltativo a una stringa con terminazione null specificando la parte del percorso previsto del file, ad esempio F:\x86. Se non specificato, viene usato il percorso in cui SetupPromptForDisk si trova più di recente in un file. Se tale elenco è vuoto, viene usato un valore predefinito di sistema.
[in] FileSought
Puntatore a una stringa con terminazione null specificando il nome del file necessario (solo parte del nome file). Il nome del file viene visualizzato se l'utente fa clic sul pulsante Sfoglia . Questa routine cerca il file usando i relativi nomi di modulo compressi; pertanto, è possibile passare cmd.exe e non preoccuparsi che il file esista effettivamente come cmd.ex_ nel supporto di origine.
[in] TagFile
Puntatore facoltativo a una stringa con terminazione null specificando un file di tag (solo parte del nome file) che identifica la presenza di un determinato volume multimediale rimovibile. Se il percorso attualmente selezionato inserisce il file su supporti rimovibili e viene specificato un file di tag, SetupPromptForDisk cerca il file di tag nella radice dell'unità per determinare se continuare.
Ad esempio, se PathToSource è A:\x86, il tagfile è disk1.tag e i tipi utente B:\x86 nel controllo di modifica della finestra di dialogo del prompt, la routine cerca B:\disk1.tag per determinare se continuare. Se il file di tag non viene trovato, la funzione cerca il tagfile usando PathToSource.
Se un file di tag non è specificato, i supporti rimovibili funzionano come supporti non rimovibili e FileSought viene cercato prima di continuare.
[in] DiskPromptStyle
Specifica il comportamento della finestra di dialogo. Questo parametro può essere una combinazione dei flag seguenti.
IDF_CHECKFIRST
Controllare la presenza del file/disco prima di visualizzare la finestra di dialogo del prompt e, se presente, restituire immediatamente DPROMPT_SUCCESS.
IDF_NOBEEP
Impedire che la finestra di dialogo venga eseguito il beping per ottenere l'attenzione dell'utente quando viene visualizzata per la prima volta.
IDF_NOBROWSE
Non visualizzare l'opzione sfoglia.
IDF_NOCOMPRESSED
Non controllare le versioni compresse del file di origine.
IDF_NODETAILS
Non visualizzare informazioni dettagliate.
IDF_NOFOREGROUND
Impedisci alla finestra di dialogo di diventare la finestra in primo piano.
IDF_NOSKIP
Non visualizzare l'opzione skip.
IDF_OEMDISK
Richiesta di un disco fornito da un produttore hardware.
IDF_WARNIFSKIP
Avvisare l'utente che ignora un file può influire sull'installazione.
[in, out] PathBuffer
Puntatore facoltativo a un buffer che, al ritorno, riceve il percorso (nessun nome file) della posizione specificata dall'utente tramite la finestra di dialogo. È consigliabile usare una stringa con terminazione Null. La stringa con terminazione null non deve superare le dimensioni del buffer di destinazione. È possibile chiamare la funzione una volta per ottenere le dimensioni del buffer necessarie, allocare la memoria necessaria e quindi chiamare la funzione una seconda volta per recuperare i dati. Usando questa tecnica, è possibile evitare errori a causa di dimensioni del buffer insufficienti. Vedere la sezione relativa alle osservazioni.
[in] PathBufferSize
Dimensioni del buffer a cui punta PathBuffer, in caratteri. Dovrebbe essere almeno MAX_PATH lungo. Include il terminatore Null .
[in, out] PathRequiredSize
Puntatore facoltativo a una variabile che riceve le dimensioni necessarie per PathBuffer, in caratteri. Include 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 un pathBuffer di NULL e un PathBufferSize pari a 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 in questo caso, il valore restituito è NO_ERROR. In caso contrario, il valore restituito è uno dei valori descritti nella sezione Valori restituiti.
Nota
L'intestazione setupapi.h definisce SetupPromptForDisk 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
| 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 |