Функции PROPVARIANT и VARIANT

В этом разделе описывается набор функций преобразования оболочки Windows и вспомогательных функций, используемых с типами PROPVARIANT и VARIANT .

Раздел	Содержимое
ClearPropVariantArray	Освобождает память и ссылки, используемые массивом структур PROPVARIANT , хранящихся в массиве.
ClearVariantArray	Освобождает память и ссылки, используемые массивом структур VARIANT , хранящихся в массиве.
FreePropVariantArray	Освобождает память и ссылки, используемые массивом структур PROPVARIANT .
InitPropVariantFromBoolean	Инициализирует заданную структуру PROPVARIANT как VT_BOOL с использованием указанного логического значения.
InitPropVariantFromBooleanVector	Инициализирует структуру PROPVARIANT из указанного логического вектора.
InitPropVariantFromBuffer	Инициализирует структуру PROPVARIANT , используя содержимое буфера.
InitPropVariantFromCLSID	Инициализирует структуру PROPVARIANT на основе идентификатора класса (CLSID).
InitPropVariantFromDouble	Инициализирует структуру PROPVARIANT на основе указанного двойного значения.
InitPropVariantFromDoubleVector	Инициализирует структуру PROPVARIANT на основе указанного вектора двойных значений.
InitPropVariantFromFileTime	Инициализирует структуру PROPVARIANT на основе информации, хранящейся в структуре FILETIME .
InitPropVariantFromFileTimeVector	Инициализирует структуру PROPVARIANT из указанного вектора значений FILETIME .
InitPropVariantFromGUIDAsBuffer	Инициализирует структуру PROPVARIANT на основе GUID. Структура инициализируется как VT_VECTOR | VT_UI1.
InitPropVariantFromGUIDAsString	Инициализирует структуру PROPVARIANT на основе GUID. Структура инициализируется как VT_LPWSTR.
InitPropVariantFromInt16	Инициализирует структуру PROPVARIANT на основе 16-разрядного целочисленного значения.
InitPropVariantFromInt16Vector	Инициализирует структуру PROPVARIANT на основе указанного вектора из 16-разрядных целочисленных значений.
InitPropVariantFromInt32	Инициализирует структуру PROPVARIANT на основе 32-разрядного целочисленного значения.
InitPropVariantFromInt32Vector	Инициализирует структуру PROPVARIANT на основе вектора 32-разрядных целочисленных значений.
InitPropVariantFromInt64	Инициализирует структуру PROPVARIANT на основе указанного значения Int64 .
InitPropVariantFromInt64Vector	Инициализирует структуру PROPVARIANT на основе вектора значений Int64 .
InitPropVariantFromPropVariantVectorElem	Инициализирует структуру PROPVARIANT на основе указанного векторного элемента PROPVARIANT .
InitPropVariantFromResource	Инициализирует структуру PROPVARIANT на основе строкового ресурса, внедренного в исполняемый файл.
InitPropVariantFromString	Инициализирует структуру PROPVARIANT на основе указанной строки.
InitPropVariantFromStringAsVector	Инициализирует структуру PROPVARIANT из указанной строки. Строка анализируется как список с разделителями точками с запятой (например: "A; B; C").
InitPropVariantFromStringVector	Инициализирует структуру PROPVARIANT из указанного строкового вектора.
InitPropVariantFromStrRet	Инициализирует структуру PROPVARIANT на основе строки, хранящейся в структуре STRRET .
InitPropVariantFromUInt16	Инициализирует структуру PROPVARIANT на основе 16-разрядного целого числа без знака.
InitPropVariantFromUInt16Vector	Инициализирует структуру PROPVARIANT на основе вектора 16-разрядных целых чисел без знака.
InitPropVariantFromUInt32	Инициализирует структуру PROPVARIANT на основе 32-разрядного целого числа без знака.
InitPropVariantFromUInt32Vector	Инициализирует структуру PROPVARIANT на основе вектора 32-разрядных целочисленных значений без знака.
InitPropVariantFromUInt64	Инициализирует структуру PROPVARIANT 64-разрядным целым числом без знака.
InitPropVariantFromUInt64Vector	Инициализирует структуру PROPVARIANT на основе вектора 64-разрядных целых чисел без знака.
InitPropVariantVectorFromPropVariant	Инициализирует элемент вектора в структуре PROPVARIANT со значением, хранящимся в другом PROPVARIANT.
InitVariantFromBoolean	Инициализирует структуру VARIANT логическим значением.
InitVariantFromBooleanArray	Инициализирует структуру VARIANT из массива логических значений.
InitVariantFromBuffer	Инициализирует структуру VARIANT с содержимым буфера.
InitVariantFromDispatch	Инициализирует структуру VARIANT на основе экземпляра объекта IDispatch .
InitVariantFromDosDateTime	Инициализирует структуру VARIANT с датой и временем в формате, используемом Microsoft MS-DOS. Значения даты и времени преобразуются в формат, используемый для хранения даты и времени в VARIANT.
InitVariantFromDouble	Инициализирует структуру VARIANT со значением типа DOUBLE.
InitVariantFromDoubleArray	Инициализирует структуру VARIANT массивом значений типа DOUBLE.
InitVariantFromFileTime	Инициализирует структуру VARIANT с содержимым структуры FILETIME .
InitVariantFromFileTimeArray	Инициализирует структуру VARIANT массивом структур FILETIME .
InitVariantFromGUIDAsBuffer	Инициализирует структуру VARIANT на основе GUID. Структура инициализируется как VT_ARRAY | VT_UI1.
InitVariantFromInt16	Инициализирует структуру PROPVARIANT на основе 16-разрядного целочисленного значения.
InitVariantFromInt16Array	Инициализирует структуру VARIANT массивом 16-разрядных целочисленных значений.
InitVariantFromInt32	Инициализирует структуру PROPVARIANT на основе 32-разрядного целочисленного значения.
InitVariantFromInt32Array	Инициализирует структуру VARIANT массивом 32-разрядных целочисленных значений.
InitVariantFromInt64	Инициализирует структуру VARIANT с 64-разрядным целочисленным значением.
InitVariantFromInt64Array	Инициализирует структуру VARIANT массивом 64-разрядных целочисленных значений.
InitVariantFromResource	Инициализирует структуру VARIANT на основе строкового ресурса, вложенного в исполняемый файл.
InitVariantFromString	Инициализирует структуру VARIANT строкой.
InitVariantFromStringArray	Инициализирует структуру VARIANT массивом строк.
InitVariantFromStrRet	Инициализирует структуру VARIANT строкой, хранящейся в структуре STRRET .
InitVariantFromUInt16	Инициализирует структуру VARIANT с 16-разрядным целочисленным значением без знака.
InitVariantFromUInt16Array	Инициализирует структуру VARIANT массивом 16-разрядных целочисленных значений без знака.
InitVariantFromUInt32	Инициализирует структуру VARIANT с 32-разрядным целочисленным значением без знака.
InitVariantFromUInt32Array	Инициализирует структуру VARIANT массивом 32-разрядных целочисленных значений без знака.
InitVariantFromUInt64	Инициализирует структуру VARIANT с 64-разрядным целочисленным значением без знака.
InitVariantFromUInt64Array	Инициализирует структуру VARIANT с 64-разрядным целочисленным значением без знака.
InitVariantFromVariantArrayElem	Инициализирует структуру VARIANT значением, хранящимся в другой структуре VARIANT .
IsPropVariantString	Указывает, является ли указанная структура PROPVARIANT строковым типом.
IsPropVariantVector	Указывает, имеет ли структура PROPVARIANT тип вектора.
IsVariantArray	Указывает, является ли вариант массивом.
IsVariantString	Указывает, является ли вариант строкой.
IsVarTypeFloat	Возвращает значение, указывающее, является ли VARTYPE типом float.
IsVarTypeInteger	Возвращает значение, указывающее, является ли VARTYPE целым числом.
IsVarTypeNumber	Указывает, является ли VARTYPE числом.
IsVarTypeSignedInteger	Возвращает значение, указывающее, является ли VARTYPE целым числом со знаком.
IsVarTypeUnsignedInteger	Возвращает значение, указывающее, является ли VARTYPE целым числом без знака.
PropVariantChangeType	Принудает значение, хранящееся в виде структуры PROPVARIANT , к эквивалентному значению другого типа варианта.
PropVariantClear	Очищает структуру PROPVARIANT .
PropVariantCompare	Сравнивает две структуры PROPVARIANT на основе единиц сравнения по умолчанию и параметров.
PropVariantCompareEx	Расширяет PropVariantCompare , позволяя вызывающему объекту сравнивать две структуры PROPVARIANT на основе указанных единиц сравнения и флагов.
PropVariantCopy	Создает копию структуры PROPVARIANT .
PropVariantGetBooleanElem	Извлекает один логический элемент из структуры PROPVARIANT типа VT_BOOL, VT_VECTOR | VT_BOOLили VT_ARRAY | VT_BOOL.
PropVariantGetDoubleElem	Извлекает один двойной элемент из структуры PROPVARIANT типа VT_R8, VT_VECTOR | VT_R8или VT_ARRAY | VT_R8.
PropVariantGetElem	Инициализирует структуру PROPVARIANT на основе указанного элемента в другой структуре PROPVARIANT .
PropVariantGetElementCount	Извлекает количество элементов структуры PROPVARIANT .
PropVariantGetFileTimeElem	Извлекает один элемент FILETIME из структуры PROPVARIANT типа VT_FILETIME, VT_VECTOR | VT_FILETIME или VT_ARRAY | VT_FILETIME.
PropVariantGetInt16Elem	Извлекает один элемент Int16 из структуры PROPVARIANT типа VT_I2, VT_VECTOR | VT_I2 или VT_ARRAY | VT_I2.
PropVariantGetInt32Elem	Извлекает один элемент Int32 из PROPVARIANT типа VT_I4, VT_VECTOR | VT_I4 или VT_ARRAY | VT_I4.
PropVariantGetInt64Elem	Извлекает один элемент Int64 из структуры PROPVARIANT типа VT_I8, VT_VECTOR | VT_I8 или VT_ARRAY | VT_I8.
PropVariantGetStringElem	Извлекает один строковый элемент Юникода из структуры PROPVARIANT типа VT_LPWSTR, VT_BSTR VT_VECTOR | VT_LPWSTR, VT_VECTOR | VT_BSTR или VT_ARRAY | VT_BSTR.
PropVariantGetUInt16Elem	Извлекает один неподписанный элемент Int16 из структуры PROPVARIANT типа VT_U12, VT_VECTOR | VT_U12 или VT_ARRAY | VT_U12.
PropVariantGetUInt32Elem	Извлекает один неподписанный элемент Int32 из структуры PROPVARIANT типа VT_UI4, VT_VECTOR | VT_UI4 или VT_ARRAY | VT_UI4.
PropVariantGetUInt64Elem	Извлекает один неподписанный элемент Int64 из структуры PROPVARIANT типа VT_UI8, VT_VECTOR | VT_UI8 или VT_ARRAY | VT_UI8.
PropVariantToBoolean	Извлекает значение логического свойства структуры PROPVARIANT . Если не удается извлечь значение, назначается значение по умолчанию.
PropVariantToBooleanVector	Извлекает логический вектор из структуры PROPVARIANT .
PropVariantToBooleanVectorAlloc	Извлекает данные из структуры PROPVARIANT в только что выделенный логический вектор.
PropVariantToBooleanWithDefault	Извлекает значение логического свойства структуры PROPVARIANT . Если значение не существует, возвращается указанное значение по умолчанию.
PropVariantToBSTR	Извлекает значение свойства BSTR структуры PROPVARIANT .
PropVariantToBuffer	Извлекает значение буфера из структуры PROPVARIANT типа VT_VECTOR | VT_UI1 или VT_ARRRAY | VT_UI1.
PropVariantToCLSID	Извлекает значение свойства CLSID структуры PROPVARIANT .
PropVariantToDouble	Извлекает значение double из структуры PROPVARIANT .
PropVariantToDoubleVector	Извлекает вектор двойников из структуры PROPVARIANT .
PropVariantToDoubleVectorAlloc	Извлекает данные из структуры PROPVARIANT в новый выделенный двойной вектор.
PropVariantToDoubleWithDefault	Извлекает значение свойства double структуры PROPVARIANT . Если значение не существует, возвращается указанное значение по умолчанию.
PropVariantToFileTime	Извлекает структуру FILETIME из структуры PROPVARIANT .
PropVariantToFileTimeVector	Извлекает данные из структуры PROPVARIANT в вектор FILETIME.
PropVariantToFileTimeVectorAlloc	Извлекает данные из структуры PROPVARIANT в новый выделенный вектор FILETIME.
PropVariantToGUID	Извлекает значение GUID из структуры PROPVARIANT .
PropVariantToInt16	Извлекает значение свойства Int16 структуры PROPVARIANT .
PropVariantToInt16Vector	Извлекает вектор значений Int16 из структуры PROPVARIANT .
PropVariantToInt16VectorAlloc	Извлекает данные из структуры PROPVARIANT в только что выделенный вектор Int16 .
PropVariantToInt16WithDefault	Извлекает значение свойства Int16 структуры PROPVARIANT . Если значение в настоящее время не существует, возвращается указанное значение по умолчанию.
PropVariantToInt32	Извлекает значение свойства Int32 структуры PROPVARIANT . Если не удается извлечь значение, назначается значение по умолчанию.
PropVariantToInt32Vector	Извлекает вектор длинных значений из структуры PROPVARIANT .
PropVariantToInt32VectorAlloc	Извлекает данные из структуры PROPVARIANT в только что выделенный вектор Int32 .
PropVariantToInt32WithDefault	Извлекает значение ULONG из структуры PROPVARIANT . Если значение не существует, возвращается указанное значение по умолчанию.
PropVariantToInt64	Извлекает значение LONGLONG из структуры PROPVARIANT . Если не удается извлечь значение, назначается значение по умолчанию.
PropVariantToInt64Vector	Извлекает данные из структуры PROPVARIANT в вектор Int64 .
PropVariantToInt64VectorAlloc	Извлекает данные из структуры PROPVARIANT в только что выделенный вектор LONGLONG .
PropVariantToInt64WithDefault	Извлекает значение свойства Int64 структуры PROPVARIANT . Если значение не существует, возвращается указанное значение по умолчанию.
PropVariantToString	Извлекает строковое значение из структуры PROPVARIANT .
PropVariantToStringAlloc	Извлекает значение строкового свойства из структуры PROPVARIANT .
PropVariantToStringVector	Извлекает вектор строк из структуры PROPVARIANT .
PropVariantToStringVectorAlloc	Извлекает данные из структуры PROPVARIANT в только что выделенные строки в новом выделенном векторе.
PropVariantToStringWithDefault	Извлекает значение строкового свойства структуры PROPVARIANT . Если значение не существует, возвращается указанное значение по умолчанию.
PropVariantToStrRet	Извлекает строку из структуры PROPVARIANT и помещает ее в структуру STRRET .
PropVariantToUInt16	Извлекает короткое значение без знака из структуры PROPVARIANT . Если не удается извлечь значение, назначается значение по умолчанию.
PropVariantToUInt16Vector	Инициализирует структуру PROPVARIANT на основе 16-разрядного целого числа без знака.
PropVariantToUInt16VectorAlloc	Извлекает данные из структуры PROPVARIANT в короткий вектор без знака.
PropVariantToUInt16WithDefault	Извлекает короткое значение без знака из структуры PROPVARIANT . Если значение не существует, возвращается указанное значение по умолчанию.
PropVariantToUInt32	Извлекает значение ULONG из структуры PROPVARIANT . Если не удается извлечь значение, назначается значение по умолчанию.
PropVariantToUInt32Vector	Извлекает данные из структуры PROPVARIANT в вектор ULONG .
PropVariantToUInt32VectorAlloc	Извлекает данные из структуры PROPVARIANT в вновь выделенный вектор ULONG .
PropVariantToUInt32WithDefault	Извлекает значение ULONG из структуры PROPVARIANT . Если значение не существует, возвращается указанное значение по умолчанию.
PropVariantToUInt64	Извлекает значение UInt64 из структуры PROPVARIANT . Если не удается извлечь значение, назначается значение по умолчанию.
PropVariantToUInt64Vector	Извлекает данные из структуры PROPVARIANT в вектор ULONGLONG .
PropVariantToUInt64VectorAlloc	Извлекает данные из структуры PROPVARIANT во вновь выделенный вектор ULONGLONG .
PropVariantToUInt64WithDefault	Извлекает значение ULONGLONG из структуры PROPVARIANT . Если значение не существует, возвращается указанное значение по умолчанию.
PropVariantToVariant	Преобразует содержимое структуры PROPVARIANT в структуру VARIANT .
StgDeserializePropVariant	Десериализует указанную структуру SERIALIZEDPROPERTYVALUE , создавая структуру PROPVARIANT .
StgSerializePropVariant	Сериализует указанную структуру PROPVARIANT , создавая структуру SERIALIZEDPROPERTYVALUE .
VariantCompare	Сравнивает две вариантные структуры на основе правил сравнения по умолчанию.
VariantGetBooleanElem	Извлекает один логический элемент из структуры variant.
VariantGetDoubleElem	Извлекает один двойной элемент из структуры варианта.
VariantGetElem	Инициализирует структуру VARIANT из указанного элемента variant.
VariantGetElementCount	Извлекает число элементов структуры варианта.
VariantGetInt16Elem	Извлекает один элемент Int16 из структуры variant.
VariantGetInt32Elem	Извлекает один элемент Int32 из структуры variant.
VariantGetInt64Elem	Извлекает один элемент Int64 из структуры variant.
VariantGetStringElem	Извлекает один широкий строковый элемент из структуры variant.
VariantGetUInt16Elem	Извлекает один неподписанный элемент Int16 из структуры вариантов.
VariantGetUInt32Elem	Извлекает один неподписанный элемент Int32 из структуры вариантов.
VariantGetUInt64Elem	Извлекает один неподписанный элемент Int64 из структуры variant.
VariantToBoolean	Извлекает значение логического свойства из структуры VARIANT . Если не удается извлечь значение, назначается значение по умолчанию.
VariantToBooleanArray	Извлекает массив логических значений из структуры VARIANT .
VariantToBooleanArrayAlloc	Выделяет массив значений BOOL , а затем извлекает данные из структуры VARIANT в этот массив.
VariantToBooleanWithDefault	Извлекает значение BOOL из структуры VARIANT . Если значение не существует, возвращается указанное значение по умолчанию.
VariantToBuffer	Извлекает содержимое буфера, хранящегося в структуре VARIANT типа VT_ARRRAY | VT_UI1.
VariantToDosDateTime	Извлекает значение даты и времени в формате MS-DOS из структуры VARIANT .
VariantToDouble	Извлекает значение DOUBLE из структуры VARIANT . Если не удается извлечь значение, назначается значение по умолчанию.
VariantToDoubleArray	Извлекает массив значений DOUBLE из структуры VARIANT .
VariantToDoubleArrayAlloc	Выделяет массив значений DOUBLE , а затем извлекает данные из структуры VARIANT в этот массив.
VariantToDoubleWithDefault	Извлекает значение DOUBLE из структуры VARIANT . Если значение не существует, возвращается указанное значение по умолчанию.
VariantToFileTime	Извлекает структуру FILETIME из структуры variant.
VariantToGUID	Извлекает значение свойства GUID для структуры варианта.
VariantToInt16	Извлекает значение свойства Int16 без знака из структуры variant. Если не удается извлечь значение, эта функция присваивает значение по умолчанию.
VariantToInt16Array	Извлекает данные из векторной структуры в массив Int16 .
VariantToInt16ArrayAlloc	Извлекает данные из векторной структуры в только что выделенный массив Int16 .
VariantToInt16WithDefault	Извлекает значение свойства Int16 из структуры variant. Если значение не существует, возвращается указанное значение по умолчанию.
VariantToInt32	Извлекает значение свойства Int32 структуры variant. Если не удается извлечь значение, назначается значение по умолчанию.
VariantToInt32Array	Извлекает данные из векторной структуры в массив Int32 .
VariantToInt32ArrayAlloc	Извлекает данные из векторной структуры в только что выделенный массив Int32 .
VariantToInt32WithDefault	Извлекает значение свойства Int32 структуры variant. Если значение не существует, возвращается указанное значение по умолчанию.
VariantToInt64	Извлекает значение свойства Int64 структуры variant. Если не удается извлечь значение, назначается значение по умолчанию.
VariantToInt64Array	Извлекает данные из векторной структуры в массив Int64 .
VariantToInt64ArrayAlloc	Извлекает данные из векторной структуры в только что выделенный массив Int64 .
VariantToInt64WithDefault	Извлекает значение свойства Int64 структуры variant. Если значение не существует, возвращается указанное значение по умолчанию.
VariantToPropVariant	Копирует содержимое структуры VARIANT в структуру PROPVARIANT .
VariantToString	Извлекает значение variant структуры варианта в строку. Если не удается извлечь значение, назначается значение по умолчанию.
VariantToStringAlloc	Извлекает значение variant структуры variant в только что выделенную строку. Если не удается извлечь значение, назначается значение по умолчанию.
VariantToStringArray	Извлекает данные из векторной структуры в массив строк.
VariantToStringArrayAlloc	Извлекает данные из векторной структуры в вновь выделенный строковый массив.
VariantToStringWithDefault	Извлекает значение строкового свойства структуры variant. Если значение не существует, возвращается указанное значение по умолчанию.
VariantToStrRet	Если исходный вариант является VT_BSTR, извлекает строку и помещает ее в структуру STRRET .
VariantToUInt16	Извлекает значение свойства Int16 без знака из структуры variant. Если не удается извлечь значение, эта функция присваивает значение по умолчанию.
VariantToUInt16Array	Извлекает данные из векторной структуры в неподписанный массив Int16 .
VariantToUInt16ArrayAlloc	Извлекает данные из векторной структуры в только что выделенный неподписанный массив Int16 .
VariantToUInt16WithDefault	Извлекает значение свойства Int16 без знака из структуры variant. Если значение не существует, возвращается указанное значение по умолчанию.
VariantToUInt32	Извлекает значение свойства Int32 без знака из структуры варианта. Если не удается извлечь значение, назначается значение по умолчанию.
VariantToUInt32Array	Извлекает данные из векторной структуры в неподписанный массив Int32 .
VariantToUInt32ArrayAlloc	Извлекает данные из векторной структуры в недавно выделенный массив Int32 без знака.
VariantToUInt32WithDefault	Извлекает значение свойства Int32 без знака из структуры variant. Если значение в настоящее время не существует, возвращается указанное значение по умолчанию.
VariantToUInt64	Извлекает значение свойства Int64 без знака из структуры variant. Если не удается извлечь значение, назначается значение по умолчанию.
VariantToUInt64Array	Извлекает данные из векторной структуры в массив Int64 без знака.
VariantToUInt64ArrayAlloc	Извлекает данные из векторной структуры в недавно выделенный массив Int64 без знака.
VariantToUInt64WithDefault	Извлекает значение свойства Int64 без знака из структуры variant. Если значение в настоящее время не существует, возвращается указанное значение по умолчанию.

 

Связанные темы

Функции контейнера свойств

Функции