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 CM_Get_HW_Prof_Flags-Funktion ruft das Hardwareprofil-spezifische Konfigurationskennzeichnungen für eine Geräteinstanz auf einem lokalen Computer ab.
Syntax
CMAPI CONFIGRET CM_Get_HW_Prof_FlagsA(
[in] DEVINSTID_A pDeviceID,
[in] ULONG ulHardwareProfile,
[out] PULONG pulValue,
[in] ULONG ulFlags
);
Parameter
[in] pDeviceID
Zeigen Sie auf eine MIT NULL beendete Zeichenfolge, die die Geräteinstanz-ID des Geräts enthält, für das hardwareprofilspezifische Konfigurationskennzeichnungen abgerufen werden sollen.
[in] ulHardwareProfile
Eine Variable vom ULONG-Typ, die den Bezeichner des Hardwareprofils angibt, für das Konfigurationskennzeichen abgerufen werden sollen. Wenn dieser Parameter null ist, ruft diese Funktion die Konfigurationskennzeichnungen für das aktuelle Hardwareprofil ab.
[out] pulValue
Zeiger auf eine vom Aufrufer bereitgestellte Variable des ULONG-Typs, die null oder ein bitweises OR der folgenden Konfigurationskennzeichen empfängt, die in Regstr.hdefiniert sind:
CSCONFIGFLAG_BITS
Bitweise ODER der anderen CSCONFIGFLAG_Xxx Flags.
CSCONFIGFLAG_DISABLE
Die Geräteinstanz ist im angegebenen Hardwareprofil deaktiviert.
CSCONFIGFLAG_DO_NOT_CREATE
Das Hardwareprofil unterstützt die angegebene Geräteinstanz nicht.
CSCONFIGFLAG_DO_NOT_START
Das Gerät kann nicht im angegebenen Hardwareprofil gestartet werden.
[in] ulFlags
Reserviert für die interne Verwendung. Muss auf 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.hdefiniert sind.
Bemerkungen
Rufen Sie SetupDiGetHwProfileListauf, um eine Liste der Hardwareprofil-IDs abzurufen, die derzeit auf einem lokalen Computer definiert sind.
Rufen Sie CM_Get_HW_Prof_Flags_Exauf, um Konfigurationskennzeichnungen für eine Geräteinstanz auf einem Remotecomputer abzurufen.
Anmerkung
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 |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Microsoft Windows 2000 und höheren Versionen von Windows. |
| Zielplattform- | Desktop |
| Header- | cfgmgr32.h (enthalten Cfgmgr32.h) |
| Library | Cfgmgr32.lib |