SetupConfigureWmiFromInfSectionA-Funktion (setupapi.h)

Artikel
08/26/2023

[Diese Funktion ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt "Anforderungen" angegeben sind. Es kann in nachfolgenden Versionen geändert oder entfernt werden. SetupAPI sollte nicht mehr für die Installation von Anwendungen verwendet werden. Verwenden Sie stattdessen den Windows Installer zum Entwickeln von Anwendungsinstallationsprogrammen. SetupAPI wird weiterhin zum Installieren von Gerätetreibern verwendet.]

Die SetupConfigureWmiFromInfSection-Funktion konfiguriert die Sicherheit der WMI-Daten, die von einer INF-Datei verfügbar gemacht werden, wenn sie an den Abschnitt [DDInstall.WMI] übergeben werden.

Es wird verwendet, um Die Sicherheit herzustellen, wenn die Version von SetupAPI auf dem System die im Abschnitt DDInstall der INF-Datei bereitgestellten WMI-Sicherheitsinformationen nicht nativ unterstützt.

Syntax

WINSETUPAPI BOOL SetupConfigureWmiFromInfSectionA(
  [in] HINF  InfHandle,
  [in] PCSTR SectionName,
  [in] DWORD Flags
);

Parameter

[in] InfHandle

Ein Handle für eine geöffnete INF-Datei.

[in] SectionName

Name des Abschnitts in der INF-Datei, der WMI-Sicherheitsinformationen enthält. Dies sollte die Form [DDinstall.WMI] haben.

[in] Flags

Dieser Parameter kann wie folgt festgelegt werden.

Flag	Bedeutung
SCWMI_CLOBBER_SECURITY 0x0001	Wenn und nur, wenn dieses Flag festgelegt ist, überschreiben die an diese Funktion übergebenen Sicherheitsinformationen alle Sicherheitsinformationen, die an anderer Stelle in der INF-Datei festgelegt sind. Wenn dieses Flag nicht vorhanden ist und keine Sicherheitsinformationen in der INF-Datei vorhanden sind, wird die Sicherheit festgelegt.

Rückgabewert

Diese Funktion gibt WINSETUPAPI BOOL zurück.

Hinweise

In früheren SetupAPI-Versionen wurden WMI-Informationen in INF-Dateien für alle Benutzer verfügbar gemacht, und der Zugriff konnte nur durch korrektes Schreiben von Binärdaten in einen Registrierungsschlüssel eingeschränkt werden. Aktuelle Versionen lesen und verarbeiten WMI-Sicherheitsinformationen, die im Abschnitt DDInstall einer INF-Datei bereitgestellt werden.

Hinweis

Der setupapi.h-Header definiert SetupConfigureWmiFromInfSection als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	setupapi.h
Bibliothek	Setupapi.lib
DLL	Setupapi.dll

Siehe auch

Funktionen

Übersicht

Angeben einer Sicherheitsbeschreibung aus einer INF-Datei

Share via