Метод IPortableDevicePropVariantCollection::Add
Метод Add добавляет элемент в коллекцию.
Синтаксис
HRESULT Add(
[in] const PROPVARIANT *pValue
);
Параметры
-
pValue [in]
-
Указатель на новый объект PROPVARIANT для добавления в коллекцию. Этот метод копирует PROPVARIANT в коллекцию, поэтому следует освободить локальную копию переменной, вызвав PropVariantClear после вызова этого метода.
Возвращаемое значение
Метод возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.
| Код возврата | Описание |
|---|---|
|
Метод выполнен успешно. |
Remarks
Если параметр VARTYPE для pValue VT_VECTOR или VT_UI1, установка и извлечение буфера NULL или нулевого размера не поддерживается. Например, ни pValue.caub.pElems = NULL , ни pValue.caub.cElems = 0 не допускаются.
Если вызывающий объект пытается добавить элемент другого VARTYPE, содержащегося в коллекции, и значение PROPVARIANT невозможно изменить с помощью этого интерфейса автоматически, этот метод завершится ошибкой. Чтобы изменить тип коллекции вручную, вызовите IPortableDevicePropVariantCollection::ChangeType.
Примеры
Пример использования этого метода см. в статье о получении идентификатора объекта из постоянного уникального идентификатора.
Требования
| Требование | Значение |
|---|---|
| Заголовок |
|
| Библиотека |
|