Método IDataModelManager2::CreateNoValue (dbgmodel.h)
El método CreateNoValue crea un objeto "sin valor", lo convierte en un objeto IModelObject y lo devuelve. El objeto de modelo devuelto tiene un tipo de ObjectNoValue.
Un objeto "sin valor" tiene varios significados semánticos:
- (Dependiendo del lenguaje), se puede considerar el equivalente semántico de void, null o undefined
- Cualquier método GetValue del descriptor de acceso de propiedad que devuelve el éxito y un objeto "sin valor" resultante indica que la propiedad determinada no tiene ningún valor para la instancia determinada y se debe tratar como si la propiedad no exista para esa instancia determinada.
- Los métodos del modelo de datos que no tienen un valor devuelto semánticamente lo usan como centinela para indicarlo (como un método debe devolver un IModelObject válido).
Sintaxis
HRESULT CreateNoValue(
IModelObject **object
);
Parámetros
object
El objeto "sin valor" recién creado/boxed se devolverá aquí.
Valor devuelto
Este método devuelve HRESULT, que indica que se ha realizado correctamente o no.
Comentarios
Código de ejemplo
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.
}
Requisitos
Requisito | Valor |
---|---|
Header | dbgmodel.h |