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

如果 pszDestNULLcchDest 为零,则 返回包含 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)