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.

Hinweis Die Verwendung dieser Funktion für den Zugriff auf Remotecomputer wird ab Windows 8 und Windows Server 2012 nicht unterstützt, da diese Funktionalität entfernt wurde.

 

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

Siehe auch

CM_Get_HW_Prof_Flags

SetupDiGetHwProfileFriendlyNameEx

SetupDiGetHwProfileListEx