Funzione SetupDiGetActualSectionToInstallExA (setupapi.h)
La funzione SetupDiGetActualSectionToInstallEx recupera il nome della sezione INF DDInstall che installa un dispositivo per un sistema operativo e un'architettura del processore specificata.
Sintassi
WINSETUPAPI BOOL SetupDiGetActualSectionToInstallExA(
[in] HINF InfHandle,
[in] PCSTR InfSectionName,
[in, optional] PSP_ALTPLATFORM_INFO AlternatePlatformInfo,
[out, optional] PSTR InfSectionWithExt,
[in] DWORD InfSectionWithExtSize,
[out, optional] PDWORD RequiredSize,
[out, optional] PSTR *Extension,
PVOID Reserved
);
Parametri
[in] InfHandle
Handle per il file INF che contiene la sezione DDInstall .
[in] InfSectionName
Puntatore al nome della sezione DDInstall (come specificato in una sezione Modelli INF). La lunghezza massima del nome della sezione, in caratteri, è 254.
[in, optional] AlternatePlatformInfo
Puntatore, se non NULL, a una struttura SP_ALTPLATFORM_INFO . Questa struttura viene usata per specificare un sistema operativo e un'architettura del processore diversa da quella nel computer locale. Per restituire il nome della sezione DDInstall per il computer locale, impostare questo parametro su NULL. In caso contrario, specificare una struttura SP_ALTPLATFORM e impostare i relativi membri come indicato di seguito:
cbSize
Impostare sulle dimensioni, in byte, di una struttura SP_ALTPLATFORM_INFO.
Piattaforma
Impostare su VER_PLATFORM_WIN32_NT per Windows XP e versioni successive di Windows.
MajorVersion
Non usato.
MinorVersion
non usata.
ProcessorArchitecture
Impostare una delle costanti dell'architettura del processore seguenti.
| Costante architettura processore | Significato |
|---|---|
| PROCESSOR_ARCHITECTURE_INTEL | La piattaforma alternativa è un'architettura del processore basata su x86. |
| PROCESSOR_ARCHITECTURE_IA64 | La piattaforma alternativa è un'architettura del processore basata su Itanium. |
| PROCESSOR_ARCHITECTURE_AMD64 | La piattaforma alternativa è un'architettura del processore basata su x64. |
Riservato
Imposta su zero.
[out, optional] InfSectionWithExt
Puntatore a un buffer di caratteri per ricevere il nome della sezione DDInstall , l'estensione della piattaforma e un terminatore NULL. Si tratta del nome della sezione decorata che deve essere usato per l'installazione. Se questo parametro è NULL, la funzione restituisce TRUE e imposta RequiredSize sulle dimensioni, in caratteri, necessaria per restituire il nome della sezione DDInstall , l'estensione della piattaforma e un carattere NULL terminante.
[in] InfSectionWithExtSize
Dimensioni, in caratteri, del buffer a cui punta il parametro InfSectionWithExt . La lunghezza massima di un nome di sezione INF con terminazione NULL, in caratteri, è MAX_INF_SECTION_NAME_LENGTH.
[out, optional] RequiredSize
Puntatore alla variabile che riceve le dimensioni, in caratteri, necessaria per restituire il nome della sezione DDInstall , l'estensione della piattaforma e un carattere NULL terminante.
[out, optional] Extension
Puntatore a una variabile che riceve un puntatore al carattere '.' che contrassegna l'inizio dell'estensione nel buffer InfSectionWithExt . Se il buffer InfSectionWithExt non viene fornito o è troppo piccolo, questo parametro non è impostato. Impostare questo parametro su NULL se non è necessario un puntatore all'estensione.
Reserved
Riservato esclusivamente per uso interno. Deve essere impostato su NULL.
Valore restituito
Se la funzione ha esito positivo, restituisce TRUE. In caso contrario, restituisce FALSE. Per informazioni dettagliate sull'errore, chiamare GetLastError.
Commenti
SetupDiGetActualSectionToInstallEx è una forma estesa di SetupDiGetActualSectionToInstall. Queste funzioni supportano le estensioni ai nomi di sezione DDInstall usati per specificare azioni di installazione specifiche del sistema operativo e specifiche dell'architettura per un dispositivo. Per informazioni su queste estensioni, vedere Creazione di file INF per più piattaforme e sistemi operativi.
Se non si forniscono informazioni sulla piattaforma alternative con una chiamata a SetupDiGetActualSectionToInstallEx, la funzione esegue la stessa operazione di SetupDiGetActualSectionToInstall. Quest'ultima funzione cerca il nome della sezione di installazione specificata usando le informazioni sulla piattaforma per il computer locale.
Se si forniscono informazioni sulla piattaforma alternative con una chiamata a SetupDiGetActualSectionToInstallEx, la funzione esegue le operazioni seguenti:
-
Se si specifica una piattaforma di VER_PLATFORM_WIN32_NT, la funzione cerca prima nel file INF specificato un nome di sezione installato decorato che corrisponde al nome, al sistema operativo e all'architettura del processore specificata. Se, ad esempio, si specifica un nome di sezione di installazione di InstallSec, la funzione cerca uno dei nomi decorati seguenti, a seconda dell'architettura del processore specificata:
- Se si specifica l'architettura del processore basata su x86, la funzione cerca il nome decorato InstallSec.ntx86.
- Se si specifica l'architettura del processore basata su x64, la funzione cerca il nome decorato InstallSec.ntamd64.
- Se si specifica l'architettura del processore basata su Itanium, la funzione cerca il nome decorato InstallSec.ntia64.
Se la funzione trova una corrispondenza per il nome, il sistema operativo e l'architettura del processore, termina la ricerca e restituisce il nome decorato corrispondente. Se la funzione non trova una corrispondenza di questo tipo, la funzione cerca una sezione il cui nome è InstallSec.nt. Se la funzione trova una corrispondenza per InstallSec.nt, termina la ricerca e restituisce questo nome. Se la funzione non trova una corrispondenza per una delle ricerche precedenti, restituisce InstallSec, ma non verifica che il file INF contenga una sezione di installazione il cui nome è InstallSec.
Nota
L'intestazione setupapi.h definisce SetupDiGetActualSectionToInstallEx 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 | Disponibile in Windows XP e versioni successive di Windows. |
| Piattaforma di destinazione | Desktop |
| Intestazione | setupapi.h (includere Setupapi.h) |
| Libreria | Setupapi.lib |