IDeviceSpecificProperty::GetValue-Methode (devicetopology.h)

Artikel
08/23/2023

Die GetValue-Methode ruft den aktuellen Wert der gerätespezifischen Eigenschaft ab.

Syntax

HRESULT GetValue(
  [out] void  *pvValue,
        DWORD *pcbValue
);

Parameter

[out] pvValue

Zeiger auf einen vom Aufrufer zugewiesenen Puffer, in den die Methode den Eigenschaftswert schreibt.

pcbValue

[inout] Zeiger auf eine DWORD-Variable , die die Größe des Eigenschaftswerts in Byte angibt. Bei der Eingabe enthält *pcbValue die Größe des vom Aufrufer zugeordneten Puffers (oder 0, wenn pvValueNULL ist). Vor der Rückgabe schreibt die Methode die tatsächliche Größe des In den Puffer geschriebenen Eigenschaftswerts (oder die erforderliche Größe, wenn der Puffer zu klein ist oder pvValueNULL ist).

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn ein Fehler auftritt, umfassen mögliche Rückgabecodes die in der folgenden Tabelle gezeigten Werte, sind jedoch nicht darauf beschränkt.

Rückgabecode	Beschreibung
E_POINTER	Der Zeiger pcbValue ist NULL.
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)	Der Puffer, auf den der Parameter pvValue verweist, ist zu klein, um den Eigenschaftswert zu enthalten, oder pvValue ist NULL , und die Größe des Eigenschaftswerts ist fest und nicht variablen. Informationen zu diesem Makro finden Sie in der Windows SDK-Dokumentation.

Hinweise

Wenn die Größe des Eigenschaftswerts nicht fest, sondern variabel ist, kann der Aufrufer die erforderliche Puffergröße abrufen, indem Er GetValue mit den Parametern pvValue = NULL und *pcbValue = 0 aufruft . Die -Methode schreibt die erforderliche Puffergröße in *pcbValue. Mit diesen Informationen kann der Aufrufer einen Puffer der erforderlichen Größe zuordnen und GetValue ein zweites Mal aufrufen, um den Eigenschaftswert abzurufen.

Wenn der vom Aufrufer zugeordnete Puffer zu klein ist, um den Eigenschaftswert zu speichern, schreibt GetValue die erforderliche Puffergröße in *pcbValue und gibt einen Fehler status Code zurück. In diesem Fall wird nichts in den Puffer geschrieben, auf den pvValue verweist.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	devicetopology.h

Share via