Функция SHLocalStrDupW (shlwapi.h)

Статья
11/20/2024

Создает копию строки в недавно выделенной памяти.

Синтаксис

HRESULT SHLocalStrDupW(
                  PCWSTR psz,
  [out, optional] PWSTR  *ppsz
);

Параметры

psz

Тип: PCTSTR

Указатель на строку Юникода, завершаемую значением NULL, которая будет скопирована.

[out, optional] ppsz

Тип: PTSTR*

Адрес указателя на выделенную строку, которая, когда эта функция возвращается успешно, получает результат. SHLocalStrDup выделяет память для этой строки с LocalAlloc. Вы должны освободить строку с LocalFree, если она больше не нужна.

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

Тип: HRESULT

Если эта функция выполнена успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT.

Замечания

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2008 [только классические приложения]
целевая платформа	Виндоус
заголовка	shlwapi.h

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