Condividi tramite


Funzione UtilStringCopyWithAlloc

La funzione UtilStringCopyWithAlloc alloca e copia una stringa di origine.

Sintassi

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

Parametri

Buffer [out]

Tipo: LPWSTR*

Posizione in cui viene archiviato il puntatore alla memoria allocata. Quando non è più necessario, deve essere rilasciato con CoTaskMemFree. Questo buffer viene sempre terminato con null.

BufferMax [in]

Tipo: UINT

Numero massimo di caratteri da leggere da Origine.

Origine [in]

Tipo: LPCWSTR

Stringa da copiare.

Valore restituito

Tipo: HRESULT

I valori restituiti possibili includono, ma non sono limitati a, quanto segue.

Codice restituito Descrizione
S_OK
Operazione completata.
E_INVALIDARG
Uno o più parametri non sono stati forniti correttamente.

Requisiti

Requisito Valore
Client minimo supportato
Windows 8 [solo app desktop]
Server minimo supportato
Windows Server 2012 [solo app desktop]
Intestazione
Ndattributils.h

Vedi anche

CoTaskMemFree

UtilAssembleStringsWithAlloc

UtilLoadStringWithAlloc