Здравствуйте, уважаемые подписчики. Перед вами очередной выпуск рассылки "WinAPI
на русском".
Сайт рассылки: http://www.bcbdev.ru. Материалы по Win32 API, C++Builder.
Раздел "WinAPI": http://www.bcbdev.ru/winapi.htm
Раздел "C++Builder": http://www.bcbdev.ru/cbuilder.htm
Раздел "Примеры кода": http://www.bcbdev.ru/codesamples.htm
Обновления на сайте
Нет.
Перевод
Сегодня вашему вниманию представлен перевод функции SHStrDup.
SHStrDup
Функция SHStrDup создает копию строки и выделяет под нее память.
HRESULT SHStrDup(
LPCTSTR pszSource,
WCHAR** ppwszTarget
);
Параметры
pszSource – указатель на копируемую строку, завершающуюся нулем.
ppwszTarget – адрес указателя на строку Unicode, содержащую результат. SHStrDup
выделяет память под эту строку, используя функцию CoTaskMemAlloc. Когда в строке
отпала необходимость, вы должны освободить память, занимаемую строкой, используя
функцию CoTaskMemFree.
Возвращаемые значения
В случае успеха возвращается S_OK.
В случае неудачи возвращается ошибка OLE.
Комментарии
Функция принимает на входе как ANSI, так и Unicode строки, но скопированная строка
на выходе всегда является строкой Unicode.
Требования
Минимальная версия DLL: shlwapi.dll версии 5.00 и выше.
Заголовок: shlwapi.h.
Библиотека импорта: shlwapi.lib.
Минимальные ОС: Windows 2000, Windows NT 4.0 с Internet Explorer 5, Windows 98,
Windows 95 с Internet Explorer 5.
См. также
StrDup.
хелп по WinAPI: http://www.bcbdev.ru/winapi/win32api.exe
С уважением,
ведущий рассылки
Тарас Сорока.
mailto:tnsoroka@online.ru