Метод IKeyStore::SetKeyValue (dbgmodel.h)

Метод SetKeyValue аналогичен методу SetKeyValue в IModelObject. Этот метод не может создавать новый ключ в хранилище метаданных. Если имеется существующий ключ, указанный аргументом ключа, его значение будет задано как указано. Если ключ является методом доступа к свойствам, метод SetValue будет вызываться для метода доступа к свойствам, чтобы задать базовое значение. Обратите внимание, что метаданные обычно являются статическими после создания. Использование этого метода в хранилище ключей метаданных должно быть редко.

Синтаксис

HRESULT SetKeyValue(
  PCWSTR       key,
  IModelObject *object
);

Параметры

key

Имя ключа для задания значения.

object

Значение, которое нужно назначить ключу. Если значение текущего ключа является методом доступа к свойствам, метод SetValue будет вызываться для метода доступа к свойствам, чтобы задать базовое значение.

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

Этот метод возвращает HRESULT, указывающий на успех или сбой.

Замечания

Пример кода

ComPtr<IKeyStore> spMetadata; /* get a metadata store */
ComPtr<IModelObject> spValue; /* get a value to set */

// This never creates a key.  Most callers should prefer SetKey
if (SUCCEEDED(spMetadata->SetKeyValue(L"KnownExistingKey", spValue.Get()))
{
    // The key's value was successfully set.
}

Требования

См. также

интерфейса IKeyStore