Compartir a través de

Función WindowsCreateString (winstring.h)

  • Artículo

Crea un nuevo HSTRING basado en la cadena de origen especificada.

Sintaxis

HRESULT WindowsCreateString(
  PCNZWCH sourceString,
  UINT32  length,
  HSTRING *string
);

Parámetros

sourceString

Tipo: [in, optional] LPCWSTR

Cadena terminada en null que se va a usar como origen para el nuevo HSTRING. Para crear una cadena nueva, vacía o NULL , pase NULL para sourceString y 0 por longitud.

length

Tipo: [in] UINT32

Longitud de sourceString, en caracteres Unicode. Debe ser 0 si sourceString es NULL.

string

Tipo: [out] HSTRING*

Puntero al HSTRING recién creado o NULL si se produce un error. Cualquier contenido existente en la cadena se sobrescribe. HSTRING es un tipo de identificador estándar.

Valor devuelto

Tipo: HRESULT

Esta función puede devolver uno de estos valores.

Código devuelto Descripción
S_OK
 HSTRING se creó correctamente.
E_INVALIDARG
 string es NULL.
E_OUTOFMEMORY
 No se pudo asignar el nuevo HSTRING.
E_POINTER
 sourceString es NULL y la longitud es distinto de cero.

Comentarios

Use la función WindowsCreateString para asignar un nuevo HSTRING. El Windows Runtime copia la cadena en el búfer de respaldo del nuevo HSTRING y administra la duración del búfer mediante un recuento de referencias. Llame a la función WindowsCreateStringReference para crear una cadena de paso rápido, que usa una cadena existente sin copiarla.

Llame a la función WindowsDeleteString para desasignar el HSTRING. Cada llamada a la función WindowsCreateString debe coincidir con una llamada a WindowsDeleteString.

Para crear una cadena nueva, vacía o NULL , pase NULL para sourceString y 0 por longitud.

Si sourceString tiene caracteres NULL incrustados, la función WindowsCreateString copia todos los caracteres en el carácter nulo de terminación.

Requisitos

   
Cliente mínimo compatible Windows 8 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2012 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado winstring.h

Consulte también

WindowsCreateStringReference

WindowsDeleteString