Str_GetPtr-Funktion

Artikel
06/13/2023

[Diese Funktion ist über Windows XP mit Service Pack 2 (SP2) und Windows Server 2003 verfügbar. In nachfolgenden Versionen von Windows ist sie möglicherweise geändert oder nicht verfügbar.]

Kopiert eine Zeichenfolge aus einem Puffer in einen anderen.

Syntax

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

Parameter

pszSource [in]

Typ: LPCTSTR

Ein Zeiger auf eine Quellzeichenfolge.

pszDest [in, out]

Typ: LPCSTR

Ein Zeiger auf den Zielpuffer. Dieser Wert kann NULL sein.

cchDest [in]

Typ: int

Die Größe von pszDest in Zeichen.

Rückgabewert

Typ: int

Wenn pszDestNULL oder cchDest null ist, gibt die Größe des Puffers in Zeichen zurück, die erforderlich ist, um eine null-endende Kopie der Zeichenfolge zu enthalten, auf die von pszSource verwiesen wird.

Wenn pszDest ungleich NULL ist, gibt die Anzahl der erfolgreich kopierten Zeichen zurück, einschließlich des abschließenden NULL-Zeichens.

Wenn pszDest nicht die gesamte Zeichenfolge enthalten kann, auf die von pszSource verwiesen wird, werden Zeichen (cchDest-1) kopiert, die Zeichenfolge null-beendet und cchDest zurückgegeben.

Bemerkungen

Str_GetPtr ist als ANSI-Versionen (Str_GetPtrA) und Unicode (Str_GetPtrW) verfügbar. Diese Funktionen werden nicht nach Namen exportiert oder in einer öffentlichen Headerdatei deklariert. Um sie zu verwenden, müssen Sie GetProcAddress verwenden und die Ordnungszahl 233 (Str_GetPtrA) oder 235 (Str_GetPtrW) von ComCtl32.dll anfordern, um einen Funktionszeiger abzurufen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
DLL	ComCtl32.dll
Unicode- und ANSI-Name	Str_GetPtrW (Unicode) und Str_GetPtrA (ANSI)

Freigeben über