SetupConfigureWmiFromInfSectionW-Funktion (setupapi.h)

Artikel
11/20/2024

[Diese Funktion steht für die Verwendung in den im Abschnitt "Anforderungen" angegebenen Betriebssystemen zur Verfügung. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein. 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 für die Installation 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 wird.

Es wird verwendet, um Sicherheit einzurichten, 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 SetupConfigureWmiFromInfSectionW(
  [in] HINF   InfHandle,
  [in] PCWSTR SectionName,
  [in] DWORD  Flags
);

Parameter

[in] InfHandle

Ein Handle zu einer geöffneten INF-Datei.

[in] SectionName

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

[in] Flags

Dieser Parameter kann wie folgt festgelegt werden.

Flagge	Bedeutung
SCWMI_CLOBBER_SECURITY 0x0001	Wenn diese Kennzeichnung festgelegt ist, überschreiben die an diese Funktion übergebenen Sicherheitsinformationen alle sicherheitsrelevanten Informationen, 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.

Bemerkungen

In früheren SetupAPI-Versionen werden WMI-Informationen in INF-Dateien für alle Benutzer verfügbar gemacht, und der Zugriff konnte nur eingeschränkt werden, indem binäre Daten ordnungsgemäß in einen Registrierungsschlüssel geschrieben werden. Aktuelle Versionen lesen und verarbeiten WMI-Sicherheitsinformationen, die vom DDInstall-Abschnitt einer INF-Datei bereitgestellt werden.

Anmerkung

Der header setupapi.h definiert SetupConfigureWmiFromInfSection als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, 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
mindestens unterstützte Client-	Keine unterstützt
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	setupapi.h
Library	Setupapi.lib
DLL-	Setupapi.dll

Siehe auch

Funktionen

Übersicht

Angeben eines Sicherheitsdeskriptors aus einer INF-Datei

Freigeben über