Share via

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

  • Artigo

Cria uma nova propriedade compartilhada com o índice especificado. Se uma propriedade compartilhada com o índice especificado já existir, CreatePropertyByPosition retornará uma referência à existente.

Sintaxe

HRESULT CreatePropertyByPosition(
  [in]  int             Index,
  [out] VARIANT_BOOL    *fExists,
  [out] ISharedProperty **ppProp
);

Parâmetros

[in] Index

O índice numérico dentro do objeto SharedPropertyGroup pelo qual a nova propriedade é referenciada. Você pode usar esse índice posteriormente para recuperar a propriedade compartilhada com o método get_PropertyByPosition .

[out] fExists

Uma referência a um valor booliano. Se fExists for definido como VARIANT_TRUE no retorno desse método, a propriedade compartilhada especificada por Index existirá antes dessa chamada. Se estiver definido como VARIANT_FALSE, a propriedade foi criada por essa chamada.

[out] ppProp

Uma referência a um objeto de propriedade compartilhada identificado pelo índice numérico passado no parâmetro Index 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 um objeto SharedProperty com o método CreatePropertyByPosition , poderá acessar essa propriedade somente usando o método get_PropertyByPosition . Não é possível atribuir um nome de cadeia de caracteres à mesma propriedade e acessá-lo usando o método get_Property . Acessar uma propriedade por posição é mais rápido do que acessar uma propriedade usando um nome de cadeia de caracteres porque requer menos sobrecarga.

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

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho comsvcs.h

Confira também

ISharedProperty

ISharedPropertyGroup