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

Crea una nueva propiedad compartida con el índice especificado. Si ya existe una propiedad compartida con el índice especificado, CreatePropertyByPosition devuelve una referencia a la existente.

Sintaxis

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

Parámetros

[in] Index

Índice numérico del objeto SharedPropertyGroup al que se hace referencia a la nueva propiedad. Puede usar este índice más adelante para recuperar la propiedad compartida con el método get_PropertyByPosition .

[out] fExists

Referencia a un valor booleano. Si fExists se establece en VARIANT_TRUE en la devolución de este método, la propiedad compartida especificada por Index existía antes de esta llamada. Si se establece en VARIANT_FALSE, esta llamada creó la propiedad .

[out] ppProp

Referencia a un objeto de propiedad compartida identificado por el índice numérico pasado en el parámetro Index 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 un objeto SharedProperty con el método CreatePropertyByPosition , solo puede acceder a esa propiedad mediante el método get_PropertyByPosition . No se puede asignar un nombre de cadena a la misma propiedad y, a continuación, acceder a ella mediante el método get_Property . El acceso a una propiedad por posición es más rápido que el acceso a una propiedad mediante un nombre de cadena porque requiere menos sobrecarga.

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

Requisitos

Consulte también

ISharedProperty

ISharedPropertyGroup