Método IDataModelManager2::CreateNoValue (dbgmodel.h)
O método CreateNoValue cria um objeto "sem valor", o coloca em um IModelObject e o retorna. O objeto de modelo retornado tem uma espécie de ObjectNoValue.
Um objeto "sem valor" tem vários significados semânticos:
- (Dependendo da linguagem), ele pode ser considerado o equivalente semântico de void, null ou indefinido
- O método GetValue de qualquer acessador de propriedade que retorna êxito e um objeto "sem valor" resultante indica que a propriedade específica não tem valor para a instância especificada e deve ser tratada como se a propriedade não existisse para essa instância específica.
- Os métodos de modelo de dados que não têm semanticamente um valor retornado usam isso como sentinela para indicar tal (como um método deve retornar um IModelObject válido).
Sintaxe
HRESULT CreateNoValue(
IModelObject **object
);
Parâmetros
object
O objeto "sem valor" recém-criado/em caixa será retornado aqui.
Retornar valor
Esse método retorna HRESULT que indica êxito ou falha.
Comentários
Código de exemplo
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 |
---|---|
Cabeçalho | dbgmodel.h |