Función WindowsGetStringRawBuffer (winstring.h)

Recupera el búfer de respaldo de la cadena especificada.

Sintaxis

PCWSTR WindowsGetStringRawBuffer(
  HSTRING string,
  UINT32  *length
);

Parámetros

string

Tipo: [in, opcional] HSTRING

Cadena opcional para la que se va a recuperar el búfer de respaldo. Puede ser NULL.

length

Tipo: [out, opcional] UINT32 *

Puntero opcional a un UINT32. Si se pasa NULL por longitud, se omite. Si length es un puntero válido a un UINT32 y string es un HSTRING válido, al finalizar correctamente, la función establece el valor al que apunta la longitud al número de caracteres Unicode del búfer de respaldo para la cadena (incluidos los caracteres NULL incrustados, pero excluyendo el valor null de terminación). Si length es un puntero válido a UINT32 y string es NULL, el valor al que apunta length se establece en 0.

Valor devuelto

Tipo: PCWSTR

Puntero al búfer que proporciona el almacén de respaldo para la cadena o la cadena vacía si la cadena es NULL o la cadena vacía.

Comentarios

Use la función WindowsGetStringRawBuffer para obtener un puntero al búfer de respaldo de un HSTRING.

No cambie el contenido del búfer: se requiere un HSTRING para que sea inmutable.

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