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

Crea una nueva propiedad compartida con el nombre especificado. Si ya existe una propiedad compartida por ese nombre, CreateProperty devuelve una referencia a la propiedad existente.

Sintaxis

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

Parámetros

[in] Name

Nombre de la propiedad que se va a crear. Puede usar este nombre más adelante para obtener una referencia a esta propiedad mediante el método get_Property .

[out] fExists

Referencia a un valor booleano que se establece en VARIANT_TRUE en la devolución de este método si la propiedad compartida especificada en el parámetro Name existía antes de esta llamada y VARIANT_FALSE si la propiedad se creó mediante esta llamada.

[out] ppProp

Referencia a un objeto SharedProperty con el nombre especificado en el parámetro Name o NULL si se encuentra un error.

Valor devuelto

Este método puede devolver los valores devueltos estándar E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, E_FAIL y S_OK.

Comentarios

Cuando se crea una propiedad compartida, su valor se establece en el valor predeterminado, que es un VT_I4 VARIANT con un valor de 0.

Si crea una propiedad compartida con el método CreateProperty , solo puede acceder a esa propiedad mediante el método get_Property . No se puede asignar un índice numérico a la misma propiedad y, a continuación, acceder a él mediante el método get_PropertyByPosition .

El mismo grupo de propiedades compartidas puede contener algunos objetos SharedProperty que se identifican por nombre y otros que se identifican por posición.

Requisitos

Consulte también

ISharedProperty

ISharedPropertyGroup