Método ISharedPropertyGroup::CreatePropertyByPosition (comsvcs.h)
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 |