IDataModelManager3::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<IDataModelManager3> 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 |