SysAllocStringLen, fonction (oleauto.h)

  • Article

Alloue une nouvelle chaîne, copie le nombre spécifié de caractères à partir de la chaîne passée et ajoute un caractère de fin null.

Syntaxe

BSTR SysAllocStringLen(
  [in] const OLECHAR *strIn,
  [in] UINT          ui
);

Paramètres

[in] strIn

Chaîne d'entrée.

[in] ui

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

Valeur retournée

Une copie de la chaîne ou NULL si la mémoire est insuffisante pour terminer l’opération.

Remarques

La chaîne peut contenir des caractères Null incorporés et n’a pas besoin de se terminer par une valeur NULL. Libérez la chaîne retournée ultérieurement avec SysFreeString. Si strIn n’est pas NULL, la mémoire allouée à strIn doit comporter au moins des caractères d’interface utilisateur .

Note Cette fonction ne convertit pas une chaîne char * en un BSTR Unicode.
 

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