IDataModelManager3 ::CreateNoValue, méthode (dbgmodel.h)
La méthode CreateNoValue crée un objet « no value », la place dans un IModelObject, puis la renvoie. L’objet de modèle retourné a un type ObjectNoValue.
Un objet « no value » a plusieurs significations sémantiques :
- (Selon le langage), il peut être considéré comme l’équivalent sémantique de void, null ou undefined
- Toute méthode GetValue de l’accesseur de propriété qui retourne la réussite et un objet « aucune valeur » résultant indique que la propriété particulière n’a pas de valeur pour l’instance donnée et doit être traitée comme si la propriété n’existait pas pour cette instance particulière.
- Les méthodes de modèle de données qui n’ont pas de valeur de retour utilisent cette valeur en tant que sentinelle pour indiquer ce type (comme une méthode doit retourner une IModelObject valide).
Syntaxe
HRESULT CreateNoValue(
IModelObject **object
);
Paramètres
object
L’objet « aucune valeur » nouvellement créé/boxé est retourné ici.
Valeur de retour
Cette méthode retourne HRESULT qui indique la réussite ou l’échec.
Remarques
exemple de code
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.
}
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | dbgmodel.h |