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
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | comsvcs.h |