Método IPortableDevicePropVariantCollection::Add
El método Add agrega un elemento a la colección.
Sintaxis
HRESULT Add(
[in] const PROPVARIANT *pValue
);
Parámetros
-
pValue [in]
-
Puntero a un nuevo objeto PROPVARIANT que se va a agregar a la colección. Este método copia el PROPVARIANT en la colección, por lo que debe liberar la copia local de la variable llamando a PropVariantClear después de llamar a este método.
Valor devuelto
El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.
| Código devuelto | Descripción |
|---|---|
|
El método se ha llevado a cabo de forma correcta. |
Comentarios
Cuando se VT_VECTOR o VT_UI1 varTYPE para pValue , no se admite la configuración ni la recuperación de un búfer null o de tamaño cero. Por ejemplo, no se permiten pValue.caub.pElems = NULL ni pValue.caub.cElems = 0.
Si un llamador intenta agregar un elemento de un VARTYPE diferente contenido en la colección y este método no puede cambiar automáticamente el valor PROPVARIANT, se producirá un error en este método. Para cambiar el tipo de colección manualmente, llame a IPortableDevicePropVariantCollection::ChangeType.
Ejemplos
Para obtener un ejemplo de cómo usar este método, consulte Recuperación de un identificador de objeto de un identificador único persistente.
Requisitos
| Requisito | Value |
|---|---|
| Encabezado |
|
| Biblioteca |
|