Метод IPropertyStore::GetValue (propsys.h)

Этот метод извлекает данные для определенного свойства.

Синтаксис

HRESULT GetValue(
  REFPROPERTYKEY key,
  PROPVARIANT    *pv
);

Параметры

key

TBD

pv

После успешного IPropertyStore::GetValue возврата метода этот параметр указывает на структуру PROPVARIANT , содержащую данные о свойстве .

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

Возвращает S_OK или INPLACE_S_TRUNCATED в случае успешного выполнения, или значение ошибки в противном случае.

INPLACE_S_TRUNCATED возвращается, чтобы указать, что возвращенный PROPVARIANT был преобразован в более каноническую форму. Например, это можно сделать, чтобы обрезать начальные или конечные пробелы из строкового значения. Для проверка возвращаемого значения необходимо использовать макрос SUCCEEDED, который обрабатывает INPLACE_S_TRUNCATED как код успешного выполнения. Макрос SUCCEEDED определен в файле Winerror.h.

Комментарии

Если propertyKEY, на который ссылается ключ в ключе, отсутствует в хранилище свойств, этот метод возвращает S_OK, а член vt структуры, на который указывает pv, имеет значение VT_EMPTY.

Требования

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

IPropertyStore

IPropertyStore::GetAt