Структура SHNAMEMAPPINGW (shellapi.h)

  • Статья

Содержит старые и новые имена путей для каждого файла, который был перемещен, скопирован или переименован функцией SHFileOperation .

Синтаксис

typedef struct _SHNAMEMAPPINGW {
  LPWSTR pszOldPath;
  LPWSTR pszNewPath;
  int    cchOldPath;
  int    cchNewPath;
} SHNAMEMAPPINGW, *LPSHNAMEMAPPINGW;

Члены

pszOldPath

Тип: LPTSTR

Адрес буфера символов, содержащего старое имя пути.

pszNewPath

Тип: LPTSTR

Адрес буфера символов, содержащего новое имя пути.

cchOldPath

Тип: int

Количество символов в pszOldPath.

cchNewPath

Тип: int

Количество символов в pszNewPath.

Комментарии

Существует две версии этой структуры: версия ANSI (SHFILEOPSTRUCTA) и версия Юникода (SHFILEOPSTRUCTW). Версия Юникода идентична версии ANSI, за исключением того, что вместо строк символов ANSI (LPCSTR) используются строки расширенных символов (LPCSTR). В Windows 98 и более ранних версий поддерживается только версия ANSI. В Microsoft Windows NT 4.0 и более поздних версий поддерживаются версии ANSI и Юникод этой структуры. SHNAMEMAPPINGA и SHNAMEMAPPINGW никогда не следует использовать напрямую; соответствующая структура переопределена прекомпилером как SHNAMEMAPPING в зависимости от того, компилируется ли приложение для ANSI или Юникода.

Примечание

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

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Верхняя часть shellapi.h

См. также раздел

SHFILEOPSTRUCT