Str_GetPtr 函数

  • 项目

[此函数通过 Windows XP 与 Service Pack 2 (SP2) 和 Windows Server 2003 提供。 它在后续版本的 Windows 中可能已更改或不可用。]

将字符串从一个缓冲区复制到另一个缓冲区。

语法

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

parameters

pszSource [in]

类型： LPCTSTR

指向源字符串的指针。

pszDest [in， out]

类型： LPCSTR

指向目标缓冲区的指针。 此值可以为 NULL。

cchDest [in]

类型： int

pszDest 的大小（以字符为单位）。

返回值

类型： int

如果 pszDest 为 NULL 或 cchDest 为零，则 返回包含 pszSource 指向的字符串的以 null 结尾的副本所需的缓冲区大小（以字符为单位）。

如果 pszDest 为非 NULL，则 返回成功复制的字符数，包括终止 null 字符。

如果 pszDest 无法容纳 pszSource 指向的整个字符串，则复制 (cchDest-1) 字符，以 null 结尾的字符串，并返回 cchDest 。

备注

Str_GetPtr 以 ANSI (Str_GetPtrA) 和 Unicode (Str_GetPtrW) 版本提供。 这些函数不会按名称导出，也不会在公共头文件中声明。 若要使用它们，必须使用 GetProcAddress 并从 ComCtl32.dll 请求序号 233 (Str_GetPtrA) 或 235 (Str_GetPtrW) 以获取函数指针。

要求

要求 值
最低受支持的客户端
 Windows Vista [仅限桌面应用]
最低受支持的服务器
 Windows Server 2003 [仅限桌面应用]
DLL
ComCtl32.dll
Unicode 和 ANSI 名称
 Str_GetPtrW (Unicode) 和 Str_GetPtrA (ANSI)