Funzione SetupGetSourceInfoA (setupapi.h)

[Questa funzione è disponibile per l'uso nei sistemi operativi indicati nella sezione Requisiti. Potrebbe essere modificato o non disponibile nelle versioni successive. SetupAPI non deve più essere usata per l'installazione di applicazioni. Usare invece Windows Installer per lo sviluppo di programmi di installazione delle applicazioni. SetupAPI continua a essere usato per l'installazione dei driver di dispositivo.

La funzione SetupGetSourceInfo recupera il percorso, il file di tag o la descrizione multimediale per un'origine elencata in un file INF.

Sintassi

WINSETUPAPI BOOL SetupGetSourceInfoA(
  [in]      HINF   InfHandle,
  [in]      UINT   SourceId,
  [in]      UINT   InfoDesired,
  [in, out] PSTR   ReturnBuffer,
  [in]      DWORD  ReturnBufferSize,
  [in, out] PDWORD RequiredSize
);

Parametri

[in] InfHandle

Handle per 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 eseguire la ricerca in base alla chiave nella sezione sourceDisksNames .

[in] InfoDesired

Indica le informazioni desiderate. È possibile specificare un solo valore per ogni chiamata di funzione e non possono essere combinati. È possibile recuperare i tipi di informazioni seguenti da una sezione SourceDisksNames.

SRCINFO_PATH

Percorso specificato per l'origine. Non si tratta di un percorso completo, ma del percorso relativo alla radice dell'installazione.

SRCINFO_TAGFILE

File di tag che identifica il supporto di origine o se vengono utilizzati archivi, il nome del file CAB.

SRCINFO_DESCRIPTION

Descrizione del supporto.

[in, out] ReturnBuffer

Puntatore facoltativo a un buffer per ricevere le informazioni recuperate. I risultati del percorso non sono garantiti per terminare con . È consigliabile usare un nullstringa con terminazione. Il nullstringa con terminazione 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 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 . Ciò include il carattere di terminazione null .

[in, out] RequiredSize

Puntatore facoltativo a una variabile che riceve le dimensioni necessarie per il buffer specificato da ReturnBuffer, in caratteri . Ciò include il carattere di terminazione null . Se viene specificato ReturnBuffer e le dimensioni effettive necessarie sono maggiori del valore specificato da ReturnBufferSize, la funzione non riesce 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 ottenere informazioni estese sull'errore, chiamare GetLastError.

Osservazioni

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 a cui punta RequiredSize. Se la funzione ha esito positivo, il valore restituito è un valore diverso da zero. In caso contrario, il valore restituito è zero e è possibile ottenere informazioni estese sull'errore chiamando GetLastError.

Fabbisogno

Vedere anche

Funzioni

panoramica

SetupGetSourceFileLocation

SetupGetSourceFileSize

SetupGetTargetPath