Función UtilStringCopyWithAlloc

La función UtilStringCopyWithAlloc asigna y copia una cadena de origen.

Sintaxis

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

Parámetros

Búfer [out]

Tipo: LPWSTR*

Ubicación donde se almacena el puntero a la memoria asignada. Cuando ya no sea necesario, debe liberarse con CoTaskMemFree. Este búfer siempre termina en null.

BufferMax [in]

Tipo: UINT

Número máximo de caracteres que se van a leer desde Source.

Origen [in]

Tipo: LPCWSTR

Cadena que se va a copiar.

Valor devuelto

Tipo: HRESULT

Entre los valores devueltos posibles se incluyen, entre otros, los siguientes.

Código devuelto	Descripción
S_OK	La operación se realizó correctamente.
E_INVALIDARG	Uno o varios parámetros no se han proporcionado correctamente.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2012 [solo aplicaciones de escritorio]
Encabezado	Ndattributils.h

Consulte también

CoTaskMemFree

UtilAssembleStringsWithAlloc

UtilLoadStringWithAlloc