Partager via


Fonction UtilStringCopyWithAlloc

La fonction UtilStringCopyWithAlloc alloue et copie une chaîne source.

Syntaxe

HRESULT UtilStringCopyWithAlloc(
  _Out_ LPWSTR  *Buffer,
  _In_  UINT    BufferMax,
  _In_  LPCWSTR Source
);

Paramètres

Mémoire tampon [out]

Type : LPWSTR*

Emplacement où le pointeur vers la mémoire allouée est stocké. Lorsqu’il n’est plus nécessaire, il doit être libéré avec CoTaskMemFree. Cette mémoire tampon est toujours terminée par null.

BufferMax [in]

Type : UINT

Nombre maximal de caractères à lire à partir de source.

Source [in]

Type : LPCWSTR

Chaîne à copier.

Valeur retournée

Type : HRESULT

Les valeurs de retour possibles incluent, sans s’y limiter, les éléments suivants.

Code de retour Description
S_OK
L’opération a réussi.
E_INVALIDARG
Un ou plusieurs paramètres n’ont pas été fournis correctement.

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge
Windows Server 2012 [applications de bureau uniquement]
En-tête
Ndattributils.h

Voir aussi

CoTaskMemFree

UtilAssembleStringsWithAlloc

UtilLoadStringWithAlloc