IPortableDeviceValues::SetStringValue-Methode

Die SetStringValue-Methode fügt einen neuen Zeichenfolgenwert hinzu (Typ VT_LPWSTR) oder überschreibt einen vorhandenen Wert.

Syntax

HRESULT SetStringValue(
  [in] REFPROPERTYKEY key,
  [in] LPCWSTR        Value
);

key [in]: Ein REFPROPERTYKEY , der das zu erstellende oder überschreibende Element angibt.
Wert [in]: Ein LPCWSTR , der den neuen Wert angibt. Die Zeichenfolge wird kopiert, damit der Aufrufer den für diesen Wert zugewiesenen Arbeitsspeicher freigeben kann, nachdem diese Methode aufgerufen wurde.

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.

Jeder vorhandene Schlüsselspeicher wird entsprechend freigegeben.

Ein Beispiel für die Verwendung dieser Methode finden Sie unter Angeben von Clientinformationen.

Anforderung	Wert
Header	PortableDeviceTypes.h
Bibliothek	PortableDeviceGUIDs.lib