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

функция Str_GetPtr

  • Статья

[Эта функция доступна в Windows XP с пакетом обновления 2 (SP2) и Windows Server 2003. Он может быть изменен или недоступен в последующих версиях Windows.]

Копирует строку из одного буфера в другой.

Синтаксис

int WINAPI Str_GetPtr(
  _In_    LPCTSTR pszSource,
  _Inout_ LPCSTR  pszDest,
  _In_    int     cchDest
);

Параметры

pszSource [in]

Тип: LPCTSTR

Указатель на исходную строку.

pszDest [in, out]

Тип: LPCSTR

Указатель на буфер назначения. Это значение может иметь значение NULL.

cchDest [in]

Тип: int

Размер pszDest в символах.

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

Тип: int

Если pszDest имеет значение NULL или cchDest равно нулю, возвращает размер буфера в символах, необходимый для хранения копии строки, на которую указывает pszSource.

Если pszDest не равно NULL, возвращает число успешно скопированных символов, включая завершающий символ NULL.

Если pszDest не может содержать всю строку, на которую указывает pszSource, то копируются символы (cchDest-1), строка завершается null и возвращается cchDest .

Комментарии

Str_GetPtr доступна в виде версий ANSI (Str_GetPtrA) и Юникода (Str_GetPtrW). Эти функции не экспортируются по имени и не объявляются в общедоступном файле заголовка. Чтобы использовать их, необходимо использовать GetProcAddress и запросить порядковый номер 233 (Str_GetPtrA) или 235 (Str_GetPtrW) из ComCtl32.dll, чтобы получить указатель функции.

Требования

Требование Значение
Минимальная версия клиента
 Windows Vista [только классические приложения]
Минимальная версия сервера
 Windows Server 2003 [только классические приложения]
DLL
ComCtl32.dll
Имя в кодировке Юникод и ANSI
 Str_GetPtrW (Юникод) и Str_GetPtrA (ANSI)