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

Метод IDataModelManager2::CreateNoValue (dbgmodel.h)

  • Статья

Метод CreateNoValue создает объект "без значения", упаковывает его в IModelObject и возвращает его. Возвращаемый объект модели имеет тип ObjectNoValue.

Объект "нет значения" имеет несколько семантических значений:

  • (В зависимости от языка) его можно считать семантиковым эквивалентом void, null или undefined.
  • Метод GetValue любого метода доступа к свойству, возвращающий успешное выполнение и результирующий объект "no value", указывает, что конкретное свойство не имеет значения для данного экземпляра и должно рассматриваться так, как если бы свойство не существовало для этого конкретного экземпляра.
  • Методы модели данных, которые семантически не имеют возвращаемого значения, используют его в качестве sentinel для указания такого значения (так как метод должен возвращать допустимый объект IModelObject).

Синтаксис

HRESULT CreateNoValue(
  IModelObject **object
);

Параметры

object

Сюда будет возвращен только что созданный или упакованный объект "no value".

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

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

Комментарии

Образец кода

ComPtr<IDataModelManager> spManager; /* get the data model manager */

ComPtr<IModelObject> spNoValue;
if (SUCCEEDED(spManager->CreateNoValue(&spNoValue)))
{
    // spNoValue contains a "no value" object.  This can be 
    // returned from IModelMethod::Call (an indication of no return value).  
    // It can be returned from a property accessor to indicate that the 
    // property has "no value" for the given instance.
}

Требования

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

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

Интерфейс IDataModelManager2