IPortableDeviceManager::GetDeviceProperty-Methode (portabledeviceapi.h)

Artikel
03/06/2024

Ruft einen Eigenschaftswert ab, der vom Gerät auf dem Computer gespeichert ist. (Dies sind keine Standardeigenschaften, die von tragbaren Windows-Geräten definiert werden.)

Syntax

HRESULT GetDeviceProperty(
  [in]      LPCWSTR pszPnPDeviceID,
  [in]      LPCWSTR pszDevicePropertyName,
  [in, out] BYTE    *pData,
  [in, out] DWORD   *pcbData,
  [in, out] DWORD   *pdwType
);

Parameter

[in] pszPnPDeviceID

Zeiger auf eine null-beendete Zeichenfolge, die die Plug & Play-ID des Geräts enthält. Sie können eine Liste mit Plug & Play Namen aller Geräte abrufen, die mit dem Computer verbunden sind, indem Sie GetDevices aufrufen.

[in] pszDevicePropertyName

Zeiger auf eine NULL-Zeichenfolge, die den Namen der anzufordernden Eigenschaft enthält. Dies sind benutzerdefinierte Eigenschaftennamen, die von einem Gerätehersteller definiert werden.

[in, out] pData

Ein vom Aufrufer zugewiesener Puffer, der die abgerufenen Daten enthält. Um die erforderliche Größe abzurufen, rufen Sie diese Methode auf, wobei dieser Parameter auf NULL und pcbData auf Null festgelegt ist, und die erforderliche Größe wird in pcbData abgerufen. Dieser Aufruf gibt auch einen Fehler zurück, der ignoriert werden kann. Siehe Rückgabewerte.

[in, out] pcbData

Die Größe des Puffers, der von pData zugewiesen oder zurückgegeben wird, in Bytes.

[in, out] pdwType

Eine Konstante, die den Typ der in pData zurückgegebenen Daten beschreibt. Die Werte für diesen Parameter sind dieselben Typen, die zum Beschreiben des lpType-Parameters der Platform SDK-Funktion RegQueryValueEx verwendet werden.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)	Der bereitgestellte Puffer ist nicht groß genug, um die angeforderten Daten aufzunehmen. (Dieses Ergebnis wird immer zurückgegeben, wenn pDataNULL ist. Sie können dieses Ergebnis ignorieren, wenn Sie die -Methode aufrufen, um die erforderliche Puffergröße abzurufen. Sehen Sie sich die Beschreibung des pData-Parameters an.)
E_POINTER	Mindestens eines der erforderlichen Argumente war ein NULL-Zeiger .

Hinweise

Diese Eigenschaftswerte werden bei der Geräteinstallation oder während des Betriebs von einem Gerät gespeichert, sodass sie über Verbindungssitzungen hinweg beibehalten werden können. Eine Anwendung muss den genauen Namen der Eigenschaft kennen, die vom Gerät selbst angegeben wird. Daher ist diese Methode für Geräteentwickler vorgesehen, die ihre eigenen Anwendungen erstellen.

Rufen Sie IPortableDeviceProperties::GetValues auf, und geben Sie das Geräteobjekt mit WPD_DEVICE_OBJECT_ID an, um Die Eigenschaften von Windows Portable Devices aus dem Geräteobjekt abzurufen.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	portabledeviceapi.h
Bibliothek	PortableDeviceGUIDs.lib

Weitere Informationen

IPortableDeviceManager-Schnittstelle

IPortableDeviceManager::GetDevices

Freigeben über