Método ISharedPropertyGroup::CreateProperty (comsvcs.h)

Cria uma nova propriedade compartilhada com o nome especificado. Se uma propriedade compartilhada por esse nome já existir, CreateProperty retornará uma referência à propriedade existente.

Sintaxe

HRESULT CreateProperty(
  [in]  BSTR            Name,
  [out] VARIANT_BOOL    *fExists,
  [out] ISharedProperty **ppProp
);

Parâmetros

[in] Name

O nome da propriedade a ser criada. Você pode usar esse nome posteriormente para obter uma referência a essa propriedade usando o método get_Property .

[out] fExists

Uma referência a um valor booliano definido como VARIANT_TRUE no retorno desse método se a propriedade compartilhada especificada no parâmetro Name existir antes dessa chamada e VARIANT_FALSE se a propriedade foi criada por essa chamada.

[out] ppProp

Uma referência a um objeto SharedProperty com o nome especificado no parâmetro Name ou NULL se um erro for encontrado.

Retornar valor

Esse método pode retornar os valores de retorno padrão E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, E_FAIL e S_OK.

Comentários

Quando você cria uma propriedade compartilhada, seu valor é definido como o padrão, que é um VT_I4 VARIANT com um valor de 0.

Se você criar uma propriedade compartilhada com o método CreateProperty , poderá acessar essa propriedade somente usando o método get_Property . Não é possível atribuir um índice numérico à mesma propriedade e acessá-lo usando o método get_PropertyByPosition .

O mesmo grupo de propriedades compartilhadas pode conter alguns objetos SharedProperty identificados pelo nome e outros identificados por posição.

Requisitos

Confira também

ISharedProperty

ISharedPropertyGroup