CM_Get_HW_Prof_FlagsW-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 die hardwareprofilspezifischen Konfigurationsflags für ein Gerät ab, das auf einem lokalen Computer instance.
Syntax
CMAPI CONFIGRET CM_Get_HW_Prof_FlagsW(
[in] DEVINSTID_W pDeviceID,
[in] ULONG ulHardwareProfile,
[out] PULONG pulValue,
[in] ULONG ulFlags
);
Parameter
[in] pDeviceID
Zeiger auf eine NULL-beendete Zeichenfolge, die das Gerät instance ID des Geräts enthält, für das Hardwareprofilspezifische Konfigurationsflags abgerufen werden sollen.
[in] ulHardwareProfile
Eine Variable vom ULONG-Typ, die den Bezeichner des Hardwareprofils angibt, für das Konfigurationsflags abgerufen werden sollen. Wenn dieser Parameter 0 ist, ruft diese Funktion die Konfigurationsflags 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 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 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
Um eine Liste der Hardwareprofil-IDs abzurufen, die derzeit auf einem lokalen Computer definiert sind, rufen Sie SetupDiGetHwProfileList auf.
Um Konfigurationsflags für ein Gerät abzurufen, das auf einem Remotecomputer instance, rufen Sie CM_Get_HW_Prof_Flags_Ex auf.
Hinweis
Der cfgmgr32.h-Header definiert CM_Get_HW_Prof_Flags 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) | Verfügbar in Microsoft Windows 2000 und höheren Versionen von Windows. |
| Zielplattform | Desktop |
| Kopfzeile | cfgmgr32.h (einschließlich Cfgmgr32.h) |
| Bibliothek | Cfgmgr32.lib |