Metodo ISharedPropertyGroup::CreatePropertyByPosition (comsvcs.h)

Crea una nuova proprietà condivisa con l'indice specificato. Se esiste già una proprietà condivisa con l'indice specificato, CreatePropertyByPosition restituisce un riferimento a quello esistente.

Sintassi

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

Parametri

[in] Index

Indice numerico all'interno dell'oggetto SharedPropertyGroup a cui fa riferimento la nuova proprietà. È possibile usare questo indice in un secondo momento per recuperare la proprietà condivisa con il metodo get_PropertyByPosition .

[out] fExists

Riferimento a un valore booleano. Se fExists è impostato su VARIANT_TRUE al ritorno da questo metodo, la proprietà condivisa specificata da Index esiste prima di questa chiamata. Se è impostato su VARIANT_FALSE, la proprietà è stata creata da questa chiamata.

[out] ppProp

Riferimento a un oggetto proprietà condivisa identificato dall'indice numerico passato nel parametro Index oppure NULL se si verifica un errore.

Valore restituito

Questo metodo può restituire i valori restituiti standard E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, E_FAIL e S_OK.

Commenti

Quando si crea una proprietà condivisa, il relativo valore viene impostato sul valore predefinito, ovvero un VT_I4 VARIANT con un valore pari a 0.

Se si crea un oggetto SharedProperty con il metodo CreatePropertyByPosition , è possibile accedere a tale proprietà solo usando il metodo get_PropertyByPosition . Non è possibile assegnare un nome stringa alla stessa proprietà e quindi accedervi usando il metodo get_Property . L'accesso a una proprietà in base alla posizione è più veloce rispetto all'accesso a una proprietà usando un nome stringa perché richiede meno sovraccarico.

Lo stesso gruppo di proprietà condiviso può contenere alcuni oggetti SharedProperty identificati dalla posizione e altri identificati dal nome.

Requisiti

Vedi anche

ISharedProperty

ISharedPropertyGroup