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

Статья
11/20/2024

Содержит старые и новые имена путей для каждого файла, который был перемещен, скопирован или переименован функцией 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, за исключением того, что широкие символьные строки (LPCWSTR) используются вместо строк символов ANSI (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

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