CM_Get_HW_Prof_FlagsA-Funktion (cfgmgr32.h)
[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 |