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 die hardwareprofilspezifischen Konfigurationsflags für ein Gerät ab, das auf einem Remotecomputer oder einem lokalen Computer instance.
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
Zeiger auf eine NULL-beendete 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 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.
[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 Konfigurationsflags 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 einen der CR_-Präfix-Fehlercodes zurück, die in Cfgmgr32.h definiert sind.
Hinweise
Rufen Sie SetupDiGetHwProfileListEx auf, um eine Liste der Hardwareprofil-IDs abzurufen, die derzeit auf einem Remotecomputer definiert sind.
Die Funktionalität für den Zugriff auf Remotecomputer wurde in Windows 8 und Windows Server 2012 und höheren Betriebssystemen entfernt, sodass Sie nicht auf Remotecomputer zugreifen können, wenn sie unter diesen Versionen von Windows ausgeführt werden.
Hinweis
Der cfgmgr32.h-Header definiert CM_Get_HW_Prof_Flags_Ex 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
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 |