CM_Get_Device_Interface_List_SizeA-Funktion (cfgmgr32.h)

Die CM_Get_Device_Interface_List_Size-Funktion ruft die Puffergröße ab, die an die CM_Get_Device_Interface_List-Funktion übergeben werden muss.

Syntax

CMAPI CONFIGRET CM_Get_Device_Interface_List_SizeA(
  [out]          PULONG      pulLen,
  [in]           LPGUID      InterfaceClassGuid,
  [in, optional] DEVINSTID_A pDeviceID,
  [in]           ULONG       ulFlags
);

Parameter

[out] pulLen

Vom Aufrufer bereitgestellter Zeiger auf eine Position, die die erforderliche Länge in Zeichen eines Puffers empfängt, um die von CM_Get_Device_Interface_List zurückgegebenen mehreren Unicode-Zeichenfolgen zu speichern.

[in] InterfaceClassGuid

Stellt eine GUID bereit, die eine Geräteschnittstellenklasse identifiziert.

[in, optional] pDeviceID

Vom Aufrufer bereitgestellter Zeiger auf eine NULL-endende Zeichenfolge, die ein Gerät instance-ID darstellt. Wenn angegeben, ruft die Funktion die Länge der symbolischen Linknamen für die Geräteschnittstellen ab, die vom Gerät unterstützt werden, für die angegebene Klasse. Wenn dieser Wert NULL ist oder auf eine Zeichenfolge der Länge Null zeigt, ruft die Funktion die Länge der symbolischen Linknamen für alle Schnittstellen ab, die zur angegebenen Klasse gehören.

[in] ulFlags

Enthält eines der folgenden vom Aufrufer bereitgestellten Flags:

Wert	Bedeutung
CM_GET_DEVICE_INTERFACE_LIST_ALL_DEVICES	Die Funktion stellt die Größe einer Liste bereit, die Geräteschnittstellen enthält, die allen Geräten zugeordnet sind, die der angegebenen GUID und der angegebenen Geräte-instance-ID (sofern vorhanden) entsprechen.
CM_GET_DEVICE_INTERFACE_LIST_PRESENT	Die Funktion stellt die Größe einer Liste bereit, die Geräteschnittstellen enthält, die geräten zugeordnet sind, die derzeit aktiv sind und der angegebenen GUID und instance-ID entsprechen, falls vorhanden.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Funktion CR_SUCCESS zurück. Andernfalls wird einer der Fehlercodes mit dem präfix CR_ zurückgegeben, wie in Cfgmgr32.h definiert.

Hinweise

Hinweis

Der cfgmgr32.h-Header definiert CM_Get_Device_Interface_List_Size 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 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
Unterstützte Mindestversion (Client)	Verfügbar in Microsoft Windows 2000 und höheren Versionen von Windows.
Zielplattform	Universell
Header	cfgmgr32.h (include Cfgmgr32.h)
Bibliothek	Cfgmgr32.lib
DLL	CfgMgr32.dll

Weitere Informationen

CM_Get_Device_Interface_List