Función WindowsCreateString (winstring.h)
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 |
|---|---|
|
HSTRING se creó correctamente. |
|
string es NULL. |
|
No se pudo asignar el nuevo HSTRING. |
|
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 |