Поделиться через


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

Метод SetKeyValue является первым методом, к который будет обращаться клиент, чтобы задать значение ключа. Этот метод нельзя использовать для создания нового ключа в объекте . Он задает только значение существующего ключа. Обратите внимание, что многие ключи доступны только для чтения (например, они реализуются методом доступа к свойству, который возвращает E_NOT_IMPL из метода SetValue). Этот метод завершится ошибкой при вызове для ключа только для чтения.

Синтаксис

HRESULT SetKeyValue(
  PCWSTR       key,
  IModelObject *object
);

Параметры

key

Имя ключа, для который необходимо задать значение.

object

В качестве значения ключа будет задан объект , содержащийся в этом аргументе.

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

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

Комментарии

Образец кода

ComPtr<IDataModelManager> spManager; /* get the data model manager */
ComPtr<IModelObject> spObject;       /* get an object with a key named SomeKey */

// Box (int)42:
VARIANT vtVal;
vtVal.vt = VT_I4;
vtVal.lVal = 42;

ComPtr<IModelObject> spNewObject;
if (SUCCEEDED(spManager->CreateIntrinsicObject(ObjectIntrinsic, &vtVal, &spNewObject)))
{
    // Set the value of "SomeKey" to our newly boxed 42:
    if (SUCCEEDED(spObject->SetKeyValue(L"SomeKey", spNewObject.Get()))
    {
        // The key value has been set!
    }
}

Требования

Требование Значение
Заголовок dbgmodel.h

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

Интерфейс IModelObject