CM_Get_HW_Prof_FlagsA-Funktion (cfgmgr32.h)

  • Artikel

[Ab Windows 8 und Windows Server 2012 ist diese Funktion veraltet und sollte nicht verwendet werden.]

Die funktion CM_Get_HW_Prof_Flags ruft die hardwareprofilspezifischen Konfigurationsflags für ein Gerät ab, das auf einem lokalen Computer instance.

Syntax

CMAPI CONFIGRET CM_Get_HW_Prof_FlagsA(
  [in]  DEVINSTID_A pDeviceID,
  [in]  ULONG       ulHardwareProfile,
  [out] PULONG      pulValue,
  [in]  ULONG       ulFlags
);

Parameter

[in] pDeviceID

Zeiger auf eine NULL-endende Zeichenfolge, die die Geräte-instance ID des Geräts enthält, für das hardwareprofilspezifische Konfigurationsflags abgerufen werden sollen.

[in] ulHardwareProfile

Eine Variable vom Typ ULONG, die den Bezeichner des Hardwareprofils angibt, für das Konfigurationsflags abgerufen werden sollen. Wenn dieser Parameter null ist, ruft diese Funktion die Konfigurationsflags für das aktuelle Hardwareprofil ab.

[out] pulValue

Zeiger auf eine vom Aufrufer bereitgestellte Variable vom ULONG-Typ, die null oder ein bitweises OR der folgenden Konfigurationsflags empfängt, die in Regstr.h definiert sind:

CSCONFIGFLAG_BITS

Bitweise OR der anderen CSCONFIGFLAG_Xxx Flags.

CSCONFIGFLAG_DISABLE

Das Gerät instance ist im angegebenen Hardwareprofil deaktiviert.

CSCONFIGFLAG_DO_NOT_CREATE

Das Hardwareprofil unterstützt die angegebene Geräte-instance nicht.

CSCONFIGFLAG_DO_NOT_START

Das Gerät kann nicht im angegebenen Hardwareprofil gestartet werden.

[in] ulFlags

Für die interne Verwendung reserviert. Muss auf 0 (null) festgelegt werden.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt CM_Get_HW_Prof_Flags CR_SUCCESS zurück. Andernfalls gibt die Funktion einen der CR_Xxx-Fehlercodes zurück, die in Cfgmgr32.h definiert sind.

Hinweise

Rufen Sie SetupDiGetHwProfileList auf, um eine Liste der Hardwareprofil-IDs abzurufen, die derzeit auf einem lokalen Computer definiert sind.

Rufen Sie CM_Get_HW_Prof_Flags_Ex auf, um Konfigurationsflags für ein Gerät abzurufen, das auf einem Remotecomputer instance.

Hinweis

Der cfgmgr32.h-Header definiert CM_Get_HW_Prof_Flags 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
Unterstützte Mindestversion (Client) Verfügbar in Microsoft Windows 2000 und höheren Versionen von Windows.
Zielplattform Desktop
Kopfzeile cfgmgr32.h (include Cfgmgr32.h)
Bibliothek Cfgmgr32.lib

Weitere Informationen

CM_Get_HW_Prof_Flags_Ex

SetupDiGetHwProfileFriendlyName

SetupDiGetHwProfileList