IDataModelManager::CreateNoValue-Methode (dbgmodel.h)
Die CreateNoValue-Methode erstellt ein "no value"-Objekt, schachtelt es in ein IModelObject ein und gibt es zurück. Das zurückgegebene Modellobjekt verfügt über eine Art ObjectNoValue.
Ein "no value"-Objekt hat mehrere semantische Bedeutungen:
- (Abhängig von der Sprache) kann es als semantische Entsprechung von void, null oder undefined betrachtet werden.
- Die GetValue-Methode eines beliebigen Eigenschaftszugriffsgebers, die den Erfolg zurückgibt, und ein resultierendes "no value"-Objekt gibt an, dass die bestimmte Eigenschaft keinen Wert für den angegebenen instance hat und so behandelt werden sollte, als ob die Eigenschaft für diesen bestimmten instance nicht vorhanden wäre.
- Datenmodellmethoden, die semantisch nicht über einen Rückgabewert verfügen, verwenden diesen als Sentinel, um diese anzugeben (da eine Methode ein gültiges IModelObject zurückgeben muss).
Syntax
HRESULT CreateNoValue(
IModelObject **object
);
Parameter
object
Das neu erstellte/boxed "no value"-Objekt wird hier zurückgegeben.
Rückgabewert
Diese Methode gibt HRESULT zurück, das auf Erfolg oder Fehler hinweist.
Hinweise
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
| Anforderung | Wert |
|---|---|
| Header | dbgmodel.h |