SetupConfigureWmiFromInfSectionW, fonction (setupapi.h)

Article
11/20/2024

[Cette fonction est disponible pour une utilisation dans les systèmes d’exploitation indiqués dans la section Configuration requise. Il peut être modifié ou indisponible dans les versions ultérieures. SetupAPI ne doit plus être utilisé pour installer des applications. Utilisez plutôt Windows Installer pour développer des programmes d’installation d’applications. SetupAPI continue d’être utilisé pour installer des pilotes de périphérique.]

La fonction SetupConfigureWmiFromInfSection configure la sécurité des données WMI exposées par un fichier INF lorsqu’elle est passée à la section [DDInstall.WMI].

Il est utilisé pour établir la sécurité lorsque la version de SetupAPI sur le système ne prend pas en charge en mode natif les informations de sécurité WMI fournies dans la section DDInstall du fichier INF.

Syntaxe

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

Paramètres

[in] InfHandle

Handle vers un fichier INF ouvert.

[in] SectionName

Nom de la section dans le fichier INF qui contient des informations de sécurité WMI. Il doit s’agir de [DDinstall.WMI].

[in] Flags

Ce paramètre peut être défini comme suit.

Drapeau	Signification
SCWMI_CLOBBER_SECURITY 0x0001	Si et uniquement si cet indicateur est défini, les informations de sécurité transmises à cette fonction remplacent tout jeu d’informations de sécurité ailleurs dans le fichier INF. Si cet indicateur n’existe pas et qu’aucune information de sécurité n’existe dans le fichier INF, la sécurité est définie.

Valeur de retour

Cette fonction retourne WINSETUPAPI BOOL.

Remarques

Dans les versions d’SetupAPI précédentes, les informations WMI dans les fichiers INF sont exposées à tous les utilisateurs et l’accès ne peut être limité qu’en écrivant correctement des données binaires dans une clé de Registre. Les versions actuelles lisent et traitent les informations de sécurité WMI fournies par la section DDInstall d’un fichier INF.

Note

L’en-tête setupapi.h définit SetupConfigureWmiFromInfSection comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence	Valeur
client minimum pris en charge	Aucun pris en charge
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	setupapi.h
bibliothèque	Setupapi.lib
DLL	Setupapi.dll

Voir aussi

Functions

Vue d’ensemble

spécification d’un descripteur de sécurité à partir d’un fichier INF

Partager via