Partager via


Str_GetPtr fonction

[Cette fonction est disponible via Windows XP avec Service Pack 2 (SP2) et Windows Server 2003. Il peut être modifié ou indisponible dans les versions ultérieures de Windows.]

Copie une chaîne d’une mémoire tampon vers une autre.

Syntaxe

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

Paramètres

pszSource [in]

Type : LPCTSTR

Pointeur vers une chaîne source.

pszDest [in, out]

Type : LPCSTR

Pointeur vers la mémoire tampon de destination. Cette valeur peut être NULL.

cchDest [in]

Type : int

Taille de pszDest, en caractères.

Valeur retournée

Type : int

Si pszDest a la valeur NULL ou si cchDest a la valeur zéro, retourne la taille de la mémoire tampon, en caractères, nécessaire pour contenir une copie null de la chaîne pointée vers pszSource.

Si pszDest n’a pas la valeur NULL, retourne le nombre de caractères correctement copiés, y compris le caractère null de fin.

Si pszDest ne peut pas contenir la chaîne entière pointée vers pszSource, les caractères (cchDest-1) sont copiés, la chaîne terminée par null et cchDest retournée.

Notes

Str_GetPtr est disponible en versions ANSI (Str_GetPtrA) et Unicode (Str_GetPtrW). Ces fonctions ne sont pas exportées par nom ou déclarées dans un fichier d’en-tête public. Pour les utiliser, vous devez utiliser GetProcAddress et demander l’ordinal 233 (Str_GetPtrA) ou 235 (Str_GetPtrW) de ComCtl32.dll pour obtenir un pointeur de fonction.

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge
Windows Server 2003 [applications de bureau uniquement]
DLL
ComCtl32.dll
Noms Unicode et ANSI
Str_GetPtrW (Unicode) et Str_GetPtrA (ANSI)