Méthode IDataModelManager2 ::CreateNoValue (dbgmodel.h)
La méthode CreateNoValue crée un objet « no value », le place dans un IModelObject et le retourne. L’objet de modèle retourné a une sorte de ObjectNoValue.
Un objet « sans valeur » a plusieurs significations sémantiques :
- (Selon la langue), il peut être considéré comme l’équivalent sémantique de void, null ou undefined
- La méthode GetValue de tout 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 aucune valeur pour le instance donné et doit être traitée comme si la propriété n’existait pas pour ce instance particulier.
- Les méthodes de modèle de données qui n’ont pas sémantiquement de valeur de retour l’utilisent en tant que sentinelle pour indiquer par exemple (comme une méthode doit retourner un IModelObject valide).
Syntaxe
HRESULT CreateNoValue(
IModelObject **object
);
Paramètres
object
L’objet « no value » nouvellement créé/boxé sera retourné ici.
Valeur retournée
Cette méthode retourne HRESULT qui indique la réussite ou l’échec.
Remarques
Exemple de Code
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.
}
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | dbgmodel.h |