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.

Requisiti

Vedi anche

Funzioni

Panoramica

SetupCopyError

SetupDeleteError

SetupRenameError