IDataModelManager2::CreateNoValue-Methode (dbgmodel.h)

Die CreateNoValue-Methode erstellt ein "no value"-Objekt, schachtelt es in ein IModelObject-und gibt es zurück. Das zurückgegebene Modellobjekt weist eine Art von ObjectNoValue auf.

Ein "no value"-Objekt hat mehrere semantische Bedeutungen:

• (Je nach Sprache) kann sie als semantische Entsprechung von "void", "null" oder "undefiniert" betrachtet werden.
• Die GetValue-Methode eines Beliebigen Eigenschaftsaccessors, die Erfolg zurückgibt, und ein resultierendes "no value"-Objekt gibt an, dass die bestimmte Eigenschaft keinen Wert für die angegebene Instanz aufweist und behandelt werden sollte, als ob die Eigenschaft für diese bestimmte Instanz nicht vorhanden war.
• Datenmodellmethoden, die semantisch keinen Rückgabewert aufweisen, verwenden dies als Sentinel, um diese anzugeben (da eine Methode eine gültige IModelObject-zurückgeben muss).

Syntax

HRESULT CreateNoValue(
  IModelObject **object
);

Parameter

object

Das neu erstellte/boxierte Objekt "no value" wird hier zurückgegeben.

Rückgabewert

Diese Methode gibt HRESULT zurück, das Erfolg oder Fehler angibt.

Bemerkungen

Beispielcode-

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.
}

Anforderungen

Siehe auch

IDataModelManager2-Schnittstelle