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 |