Compartilhar via


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

Confira também

Interface IDataModelManager2