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