Función WindowsCreateString (winstring.h)

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

Syntax

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

Parámetros

sourceString

Tipo: [in, opcional] LPCWSTR

Búfer de texto con codificación UTF-16LE que se usará como origen para el nuevo HSTRING. Para crear una cadena nueva, vacía o NULL , pase NULL para sourceString y 0 por longitud.

No es necesario que este búfer termine en null. WindowsCreateString copiará su contenido y agregará un terminador NULL en el nuevo búfer que respalda el HSTRING devuelto.

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. Se sobrescribe cualquier contenido existente en la cadena . HSTRING es un tipo de identificador estándar.

Valor devuelto

Tipo: HRESULT

Esta función puede devolver uno de estos valores.

Código de retorno	Description
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 no es cero.

Observaciones

Use la función WindowsCreateString para asignar un nuevo HSTRING. 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

Requirement	Importancia
Cliente mínimo compatible	Windows 8 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo admitido	Windows Server 2012 [aplicaciones de escritorio | Aplicaciones para UWP]
de la plataforma de destino de	Windows
Header	winstring.h
Library	RuntimeObject.lib

Consulte también

WindowsCreateStringReference

WindowsDeleteString