Funzione SetupGetSourceInfoW (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 SetupGetSourceInfo recupera il percorso, il file tag o la descrizione multimediale per un'origine elencata in un file INF.
Sintassi
WINSETUPAPI BOOL SetupGetSourceInfoW(
[in] HINF InfHandle,
[in] UINT SourceId,
[in] UINT InfoDesired,
[in, out] PWSTR ReturnBuffer,
[in] DWORD ReturnBufferSize,
[in, out] PDWORD RequiredSize
);
Parametri
[in] InfHandle
Handle in un file INF aperto che contiene una sezione SourceDisksNames . Se esistono sezioni specifiche della piattaforma per il sistema dell'utente,ad esempio SourceDisksNames.x86, verrà usata la sezione specifica della piattaforma.
[in] SourceId
Identificatore per un supporto di origine. Questo valore viene usato per cercare in base alla chiave nella sezione SourceDisksNames .
[in] InfoDesired
Indica le informazioni desiderate. È possibile specificare un solo valore per chiamata di funzione e non è possibile combinare. I tipi di informazioni seguenti possono essere recuperati da una sezione SourceDisksNames .
SRCINFO_PATH
Percorso specificato per l'origine. Non si tratta di un percorso completo, ma il percorso relativo alla radice dell'installazione.
SRCINFO_TAGFILE
File di tag che identifica il supporto di origine o se vengono usati i contenitori, il nome del file cabinet.
SRCINFO_DESCRIPTION
Descrizione del supporto.
[in, out] ReturnBuffer
Puntatore facoltativo a un buffer per ricevere le informazioni recuperate. I restituiti del percorso non sono garantiti per terminare con . È 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. Vedere la sezione relativa alle osservazioni. Usando questa tecnica, è possibile evitare errori a causa di dimensioni del buffer insufficienti. Questo parametro può essere NULL.
[in] ReturnBufferSize
Dimensioni del buffer a cui punta returnBuffer, in caratteri. Include il terminatore Null .
[in, out] RequiredSize
Puntatore facoltativo a una variabile che riceve le dimensioni necessarie per il buffer specificato da ReturnBuffer, in caratteri. Include il terminatore Null . Se ReturnBuffer è specificato e le dimensioni effettive necessarie sono maggiori del valore specificato da ReturnBufferSize, la funzione ha esito negativo e una chiamata a GetLastError restituisce ERROR_INSUFFICIENT_BUFFER.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è un valore diverso da zero.
Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.
Commenti
Se questa funzione viene chiamata con un ReturnBuffer di NULL e un ReturnBufferSize pari a zero, la funzione inserisce le dimensioni del buffer necessarie per contenere i dati specificati nella variabile puntata a RequiredSize. Se la funzione ha esito positivo in questo caso, il valore restituito è un valore diverso da zero. In caso contrario, il valore restituito è zero e le informazioni di errore estese possono essere ottenute chiamando GetLastError.
Nota
L'intestazione setupapi.h definisce SetupGetSourceInfo 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 |
Vedi anche
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per