Share via

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
);

參數

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並要求序數 233 (Str_GetPtrA) 或 235 (Str_GetPtrW) 從 ComCtl32.dll 取得函式指標。

規格需求

需求 值
最低支援的用戶端
 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器
 Windows Server 2003 [僅限桌面應用程式]
DLL
ComCtl32.dll
Unicode 與 ANSI 名稱
 Str_GetPtrW (Unicode ) 和 Str_GetPtrA (ANSI)