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.

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

Consulte también

WindowsCreateStringReference

WindowsDeleteString