Метод 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!
    }
}

Требования

См. также

интерфейс IModelObject