Metodo IDataModelManager2::CreateNoValue (dbgmodel.h)
Il metodo CreateNoValue crea un oggetto "nessun valore", lo inserisce in un oggetto IModelObject e lo restituisce. L'oggetto modello restituito ha un tipo objectNoValue.
Un oggetto "no value" ha diversi significati semantici:
- (A seconda del linguaggio), può essere considerato l'equivalente semantico di void, null o non definito
- Qualsiasi metodo GetValue della funzione di accesso alle proprietà che restituisce l'esito positivo e un oggetto "nessun valore" risultante indica che la proprietà specifica non ha alcun valore per l'istanza specificata e deve essere considerata come se la proprietà non esistesse per tale istanza specifica.
- I metodi del modello di dati che non dispongono semanticamente di un valore restituito usano questo valore come sentinel per indicare, ad esempio un metodo deve restituire un IModelObject valido.
Sintassi
HRESULT CreateNoValue(
IModelObject **object
);
Parametri
object
L'oggetto "nessun valore" appena creato/boxed verrà restituito qui.
Valore restituito
Questo metodo restituisce HRESULT che indica l'esito positivo o negativo.
Commenti
Codice di esempio
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.
}
Requisiti
Requisito | Valore |
---|---|
Intestazione | dbgmodel.h |