SetupConfigureWmiFromInfSectionA, fonction (setupapi.h)

[Cette fonction peut être utilisée dans les systèmes d’exploitation indiqués dans la section Configuration requise. Il sera 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 les pilotes de périphérique.]

La fonction SetupConfigureWmiFromInfSection configure la sécurité des données WMI exposées par un fichier INF lorsqu’elles sont passées à 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 SetupConfigureWmiFromInfSectionA(
  [in] HINF  InfHandle,
  [in] PCSTR SectionName,
  [in] DWORD Flags
);

Paramètres

[in] InfHandle

Handle pour 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.

Indicateur	Signification
SCWMI_CLOBBER_SECURITY 0x0001	Si et seulement 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 retournée

Cette fonction retourne WINSETUPAPI BOOL.

Remarques

Dans les versions précédentes de SetupAPI, les informations WMI dans les fichiers INF sont exposées à tous les utilisateurs, et l’accès ne pouvait ê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.

Notes

L’en-tête setupapi.h définit SetupConfigureWmiFromInfSection en tant qu’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. La combinaison 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.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	setupapi.h
Bibliothèque	Setupapi.lib
DLL	Setupapi.dll

Voir aussi

Fonctions

Vue d'ensemble

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