Функция GetExpandedNameW (lzexpand.h)

Статья
11/20/2024

Извлекает исходное имя сжатого файла, если файл был сжатым алгоритмом Lempel-Ziv.

Синтаксис

INT GetExpandedNameW(
  [in]  LPWSTR lpszSource,
  [out] LPWSTR lpszBuffer
);

Параметры

[in] lpszSource

Имя сжатого файла.

[out] lpszBuffer

Указатель на буфер, получающий исходное имя сжатого файла.

Возвращаемое значение

Если функция выполнена успешно, возвращаемое значение равно 1.

Если функция завершается ошибкой, возвращаемое значение LZERROR_BADVALUE. Для этой функции нет расширенных сведений об ошибке; не вызывайте GetLastError.

ПримечаниеGetExpandedName вызывает ни SetLastError, ни SetLastErrorEx; Таким образом, его сбой не влияет на код последней ошибки потока.

Замечания

Содержимое буфера, на которое указывает параметр lpszBuffer, — это исходное имя файла, если файл был сжат с помощью параметра /r. Если параметр /r не использовался, эта функция дублирует имя в параметре lpszSource в буфер lpszBuffer.

В Windows 8 и Windows Server 2012 эта функция поддерживается следующими технологиями.

Технологии	Поддержанный
Протокол SMB 3.0	Да
Отработка отказа SMB 3.0 (TFO)	Да
SMB 3.0 с масштабируемыми общими папками (SO)	Да
Файловая система общего тома кластера (CSVFS)	Да
Отказоустойчивая файловая система (ReFS)	Да

Заметка

Заголовок lzexpand.h определяет GetExpandedName как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	lzexpand.h (включая Windows.h)
библиотеки	Lz32.lib
DLL	Lz32.dll

См. также

сжатия файлов и декомпрессии

функции управления файлами

Поделиться через