IPortableDeviceValues::GetStringValue-Methode

Die GetStringValue-Methode ruft einen Zeichenfolgenwert (Typ VT _ LPWSTR) ab, der durch einen Schlüssel angegeben wird.

Syntax

HRESULT GetStringValue(
  [in]  REFPROPERTYKEY key,
  [out] LPWSTR         *pValue
);

Parameter

key [ In]

Ein REFPROPERTYKEY-Schlüssel, der das abzurufende Element angibt.

pValue [ out]

Zeiger auf den abgerufenen LPWSTR-Wert. Der Aufrufer ist für den Aufruf von CoTaskMemFree verantwortlich, um den Arbeitsspeicher freizugeben.

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.
DISP _ E _ TYPEMISMATCH
Die durch key angegebene Eigenschaft ist kein LPWSTR-Typ.
HRESULT _ VON _ WIN32 (FEHLER _ NICHT _ GEFUNDEN)
Die vom Schlüssel angegebene Eigenschaft befindet sich nicht in der Auflistung.

Beispiele

Ein Beispiel für die Verwendung dieser Methode finden Sie unter Abrufen von unterstützten Dienstereignissen.

Requirements (Anforderungen)

Anforderung Wert
Header
PortableDeviceTypes.h
Bibliothek
PortableDeviceGUIDs.lib

Weitere Informationen

IPortableDeviceValues-Schnittstelle

IPortableDeviceValues::GetAt

IPortableDeviceValues::SetStringValue

Abrufen von unterstützten Dienstereignissen

Abrufen unterstützter Dienstformate

Abrufen unterstützter Dienstmethoden