Str _ GetPtr-Funktion

[Diese Funktion ist über Windows XP mit Service Pack 2 (SP2) und Windows Server 2003 verfügbar. Sie kann in nachfolgenden Versionen von geändert oder nicht verfügbar Windows.]

Kopiert eine Zeichenfolge von 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 pszDest NULL oder cchDest 0 (null) ist, gibt die Größe des Puffers in Zeichen zurück, die eine auf NULL terminierte Kopie der Zeichenfolge enthalten muss, auf die pszSource zeigt.

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

Wenn pszDest nicht die gesamte Zeichenfolge enthalten kann, auf die pszSource zeigt, werden (cchDest-1) Zeichen kopiert, die Zeichenfolge mit NULL-Terminierung und cchDest zurückgegeben.

Bemerkungen

Str _ GetPtr ist als ANSI- (Str _ GetPtrA) und Unicode-Versionen (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 zu erhalten.

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Nur [ Vista-Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Nur Server [ 2003-Desktop-Apps]
DLL
ComCtl32.dll
Unicode- und ANSI-Name
Str _ GetPtrW (Unicode) und Str _ GetPtrA (ANSI)