CM_Get_HW_Prof_Flags_ExA Funktion (cfgmgr32.h)
[Diese Funktion ist veraltet und sollte nicht verwendet werden.]
Die CM_Get_HW_Prof_Flags_Ex-Funktion ruft das Hardwareprofil-spezifische Konfigurationskennzeichnungen für eine Geräteinstanz auf einem Remotecomputer oder einem lokalen Computer ab.
Syntax
CMAPI CONFIGRET CM_Get_HW_Prof_Flags_ExA(
[in] DEVINSTID_A pDeviceID,
[in] ULONG ulHardwareProfile,
[out] PULONG pulValue,
[in] ULONG ulFlags,
[in, optional] HMACHINE hMachine
);
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.
[in, optional] hMachine
Ein Computerhandle, das durch Aufruf von CM_Connect_Machine oder NULL-zurückgegeben wird. Wenn dieser Parameter auf NULL-festgelegt ist, ruft CM_Get_HW_Prof_Flags_Ex die Konfigurationskennzeichnungen auf dem lokalen Computer ab.
Rückgabewert
Wenn der Vorgang erfolgreich ist, gibt CM_Get_HW_Prof_Flags CR_SUCCESS zurück. Andernfalls gibt die Funktion eine der CR_-präfixierten Fehlercodes zurück, die in Cfgmgr32.hdefiniert sind.
Bemerkungen
Rufen Sie SetupDiGetHwProfileListExauf, um eine Liste der Hardwareprofil-IDs abzurufen, die derzeit auf einem Remotecomputer definiert sind.
Funktionen für den Zugriff auf Remotecomputer wurden in Windows 8 und Windows Server 2012 und höher entfernt, daher können Sie nicht auf Remotecomputer zugreifen, wenn sie auf diesen Versionen von Windows ausgeführt werden.
Anmerkung
Der cfgmgr32.h-Header definiert CM_Get_HW_Prof_Flags_Ex 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 |