Metodo ISharedPropertyGroup::CreateProperty (comsvcs.h)

Crea una nuova proprietà condivisa con il nome specificato. Se esiste già una proprietà condivisa in base al nome, CreateProperty restituisce un riferimento alla proprietà esistente.

Sintassi

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

Parametri

[in] Name

Nome della proprietà da creare. È possibile usare questo nome in un secondo momento per ottenere un riferimento a questa proprietà usando il metodo get_Property .

[out] fExists

Riferimento a un valore booleano impostato su VARIANT_TRUE restituito da questo metodo se la proprietà condivisa specificata nel parametro Name esiste prima di questa chiamata e VARIANT_FALSE se la proprietà è stata creata da questa chiamata.

[out] ppProp

Riferimento a un oggetto SharedProperty con il nome specificato nel parametro Name o NULL se viene rilevato 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 è impostato sul valore predefinito, ovvero un VT_I4 VARIANT con un valore pari a 0.

Se si crea una proprietà condivisa con il metodo CreateProperty , è possibile accedere a tale proprietà solo usando il metodo get_Property . Non è possibile assegnare un indice numerico alla stessa proprietà e quindi accedervi usando il metodo get_PropertyByPosition .

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

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	comsvcs.h

Vedi anche

ISharedProperty

ISharedPropertyGroup