Метод IPortableDeviceValues::SetStringValue

Метод SetStringValue добавляет новое строковое значение (тип VT_LPWSTR) или перезаписывает существующее.

Синтаксис

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

Параметры

key [in]

REFPROPERTYKEY, указывающий элемент для создания или перезаписи.

Значение [in]

Объект LPCWSTR, указывающий новое значение. Строка копируется, поэтому вызывающий объект может освободить память, выделенную для этого значения, после вызова этого метода.

Возвращаемое значение

Метод возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.

Код возврата Описание
S_OK
Метод выполнен успешно.

Комментарии

Любая существующая память ключа будет освобождена соответствующим образом.

Примеры

Пример использования этого метода см. в разделе Указание сведений о клиенте.

Требования

Требование Значение
Заголовок
PortableDeviceTypes.h
Библиотека
PortableDeviceGUIDs.lib

См. также раздел

Добавление ресурса в объект

Интерфейс IPortableDeviceValues

IPortableDeviceValues::GetStringValue

Настройка свойств для одного объекта

Настройка свойств для нескольких объектов

Указание сведений о клиенте

Написание свойств content-object