Funzione SetupConfigureWmiFromInfSectionW (setupapi.h)

Articolo
11/20/2024

[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 setupConfigureWmiFromInfSection consente di configurare la sicurezza dei dati WMI esposti da un file INF quando viene passato alla sezione [DDInstall.WMI].

Viene usato per stabilire la sicurezza quando la versione di SetupAPI nel sistema non supporta in modo nativo le informazioni di sicurezza WMI fornite nella sezione DDInstall del file INF.

Sintassi

WINSETUPAPI BOOL SetupConfigureWmiFromInfSectionW(
  [in] HINF   InfHandle,
  [in] PCWSTR SectionName,
  [in] DWORD  Flags
);

Parametri

[in] InfHandle

Handle per un file INF aperto.

[in] SectionName

Nome della sezione nel file INF che contiene informazioni di sicurezza WMI. Deve essere nel formato [DDinstall.WMI].

[in] Flags

Questo parametro può essere impostato come segue.

Bandiera	Significato
SCWMI_CLOBBER_SECURITY 0x0001	Se e solo se questo flag è impostato, le informazioni di sicurezza passate a questa funzione sostituiscono eventuali informazioni di sicurezza impostate altrove nel file INF. Se questo flag non esiste e nel file INF non sono presenti informazioni di sicurezza, viene impostata la sicurezza.

Valore restituito

Questa funzione restituisce WINSETUPAPI BOOL.

Osservazioni

Nelle versioni precedenti di SetupAPI le informazioni WMI nei file INF vengono esposte a tutti gli utenti e l'accesso potrebbe essere limitato solo scrivendo correttamente dati binari in una chiave del Registro di sistema. Le versioni correnti leggono ed elaborano le informazioni di sicurezza WMI fornite dalla sezione DDInstall di un file INF.

Nota

L'intestazione setupapi.h definisce SetupConfigureWmiFromInfSection come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Nessuna supportata
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	setupapi.h
libreria	Setupapi.lib
dll	Setupapi.dll

Vedere anche

Funzioni

panoramica

Specifica di un descrittore di sicurezza da un di file INF

Condividi tramite