Método IDataModelManager3::CreateNoValue (dbgmodel.h)

Artigo
12/20/2024

O método CreateNoValue cria um objeto "sem valor", o coloca em uma IModelObject e o retorna. O objeto de modelo retornado tem um tipo de ObjectNoValue.

Um objeto "sem valor" tem vários significados semânticos:

(Dependendo da linguagem), ele pode ser considerado o equivalente semântico de nulo, nulo 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 determinada e deve ser tratada como se a propriedade não existisse para essa instância específica.
Métodos de modelo de dados que não têm um valor retornado semanticamente usam isso como sentinela para indicar tal (como um método deve retornar um IModelObjectválido).

Sintaxe

HRESULT CreateNoValue(
  IModelObject **object
);

Parâmetros

object

O objeto "sem valor" recém-criado/em caixa será retornado aqui.

Valor de retorno

Esse método retorna HRESULT que indica êxito ou falha.

Observações

de código de exemplo

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.
}

Requisitos

Requisito	Valor
cabeçalho	dbgmodel.h

Consulte também

interface IDataModelManager3

Compartilhar via