SysReAllocStringLen, fonction (oleauto.h)

Crée un BSTR contenant un nombre spécifié de caractères à partir d’un ancien BSTR et libère l’ancien BSTR.

Syntaxe

INT SysReAllocStringLen(
  [in, out]      BSTR          *pbstr,
  [in, optional] const OLECHAR *psz,
  [in]           unsigned int  len
);

Paramètres

[in, out] pbstr

Chaîne précédemment allouée.

[in, optional] psz

Chaîne à partir de laquelle copier les caractères len , ou NULL pour conserver la chaîne non initialisée.

[in] len

Nombre de caractères à copier. Un caractère null est placé par la suite, en allouant un total de len plus un caractère.

Valeur retournée

Code de retour	Description
TRUE	La chaîne est réaffectée avec succès.
FALSE	Mémoire insuffisante.

Remarques

Alloue une nouvelle chaîne, copie les caractères len de la chaîne passée dans celle-ci, puis ajoute un caractère null. Libère le BSTR référencé actuellement par pbstr et réinitialise pbstr pour qu’il pointe vers le nouveau BSTR. Si psz a la valeur Null, une chaîne de longueur len est allouée, mais pas initialisée.

La chaîne psz peut contenir des caractères Null incorporés et n’a pas besoin de se terminer par une valeur null.

Si un pointeur NULL est passé à cette fonction, il y aura une violation d’accès et le programme se bloquera. Il est de votre responsabilité de protéger cette fonction contre les pointeurs NULL.

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	oleauto.h
Bibliothèque	OleAut32.lib
DLL	OleAut32.dll

Voir aussi

Fonctions de manipulation de chaînes