CM_Get_Device_Interface_Property_Keys_ExW-Funktion (cfgmgr32.h)

Artikel
08/22/2023

[Ab Windows 8 und Windows Server 2012 ist diese Funktion veraltet. Verwenden Sie stattdessen CM_Get_Device_Interface_Property_Keys .]

Die CM_Get_Device_Interface_Property_Keys_ExW-Funktion ruft ein Array von Geräteeigenschaftenschlüsseln ab, die die Geräteeigenschaften darstellen, die für eine Geräteschnittstelle festgelegt sind.

Syntax

CMAPI CONFIGRET CM_Get_Device_Interface_Property_Keys_ExW(
  [in]            LPCWSTR    pszDeviceInterface,
  [out, optional] DEVPROPKEY *PropertyKeyArray,
  [in, out]       PULONG     PropertyKeyCount,
  [in]            ULONG      ulFlags,
  [in, optional]  HMACHINE   hMachine
);

Parameter

[in] pszDeviceInterface

Zeiger auf eine Zeichenfolge, die die Geräteschnittstelle identifiziert, von der instance die Eigenschaftenschlüssel abgerufen werden sollen.

[out, optional] PropertyKeyArray

Zeiger auf einen Puffer, der ein Array von DEVPROPKEY-typisierten Werten empfängt, wobei jeder Wert ein Geräteeigenschaftenschlüssel ist, der eine Geräteeigenschaft darstellt, die für die Geräteschnittstelle festgelegt ist. Der Zeiger ist optional und kann NULL sein.

[in, out] PropertyKeyCount

Die Größe des PropertyKeyArray-Puffers in DEVPROPKEY-typisierten Einheiten. Wenn PropertyKeyArray auf NULL festgelegt ist, muss *PropertyKeyCount auf 0 festgelegt werden. Wenn PropertyKeyArray nicht groß genug ist, um alle Eigenschaftenschlüsseldaten aufzunehmen, gibt CM_Get_Device_Interface_Property_Keys_ExW die Anzahl der Schlüssel in *PropertyKeyCount zurück.

[in] ulFlags

Reserviert. Muss auf 0 festgelegt werden.

[in, optional] hMachine

Vom Anrufer bereitgestellter Maschinenhandle, der aus einem vorherigen Aufruf von CM_Connect_Machine abgerufen wurde.

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 die Funktion CR_SUCCESS zurück. Andernfalls wird einer der CR_-Präfix-Fehlercodes zurückgegeben, die in Cfgmgr32.h definiert sind.

Hinweise

CM_Get_Device_Interface_Property_Keys_ExW ist Teil des Unified Device-Eigenschaftsmodells.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Microsoft Windows 10 und höheren Versionen von Windows.
Zielplattform	Desktop
Kopfzeile	cfgmgr32.h (einschließlich Cfgmgr32.h)
Bibliothek	Cfgmgr32.lib

Weitere Informationen

CM_Connect_Machine

SetupDiGetDeviceInterfacePropertyKeys

Freigeben über