CM_Get_Device_Interface_Property_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 .]

Die CM_Get_Device_Interface_Property_ExW-Funktion ruft eine Geräteeigenschaft ab, die für eine Geräteschnittstelle festgelegt ist.

Syntax

CMAPI CONFIGRET CM_Get_Device_Interface_Property_ExW(
  [in]           LPCWSTR          pszDeviceInterface,
  [in]           const DEVPROPKEY *PropertyKey,
  [out]          DEVPROPTYPE      *PropertyType,
  [out]          PBYTE            PropertyBuffer,
  [in, out]      PULONG           PropertyBufferSize,
  [in]           ULONG            ulFlags,
  [in, optional] HMACHINE         hMachine
);

Parameter

[in] pszDeviceInterface

Zeiger auf eine Zeichenfolge, die die Geräteschnittstelle identifiziert, von der instance die Eigenschaft abgerufen werden soll.

[in] PropertyKey

Zeiger auf eine DEVPROPKEY-Struktur , die den Geräteschnittstelleneigenschaftsschlüssel der abzurufenden Geräteschnittstelleneigenschaft darstellt.

[out] PropertyType

Zeiger auf eine DEVPROPTYPE-typisierte Variable, die den Eigenschaftsdatentypbezeichner der angeforderten Geräteschnittstelleneigenschaft empfängt. Der Eigenschaftsdatentypbezeichner ist ein bitweiser OR zwischen einem Basisdatentypbezeichner und, wenn der Basisdatentyp geändert wird, einem Property-data-type-Modifizierer.

[out] PropertyBuffer

Ein Zeiger auf einen Puffer, der die angeforderte Geräteschnittstelleneigenschaft empfängt. CM_Get_Device_Interface_Property_ExW ruft die angeforderte Eigenschaft nur ab, wenn der Puffer groß genug ist, um alle Eigenschaftenwertdaten zu enthalten. Der Zeiger kann NULL sein.

[in, out] PropertyBufferSize

Die Größe des PropertyBuffer-Puffers in Bytes. Wenn PropertyBuffer auf NULL festgelegt ist, muss *PropertyBufferSize auf Null festgelegt werden. Wenn der Puffer nicht groß genug ist, um alle Eigenschaftenwertdaten aufzunehmen, gibt CM_Get_Device_Interface_Property_ExW die Größe der Daten in Bytes in *PropertyBufferSize 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_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
DLL	CfgMgr32.dll

Weitere Informationen

CM_Connect_Machine

SetupDiGetDeviceInterfaceProperty

Freigeben über