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
);

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.

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 schlüssel angegebene Eigenschaft ist kein LPWSTR-Typ .
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	Die durch schlüssel angegebene Eigenschaft befindet sich nicht in der Auflistung.

Ein Beispiel für die Verwendung dieser Methode finden Sie unter Abrufen unterstützter Dienstereignisse.

Anforderung	Wert
Header	PortableDeviceTypes.h
Bibliothek	PortableDeviceGUIDs.lib