Функция WindowsGetStringRawBuffer (winstring.h)

Извлекает резервный буфер для указанной строки.

Синтаксис

PCWSTR WindowsGetStringRawBuffer(
  HSTRING string,
  UINT32  *length
);

Параметры

string

Тип: [in, необязательно] HSTRING

Необязательная строка, для которой требуется извлечь резервный буфер. Может иметь значение NULL.

length

Тип: [out, необязательный] UINT32 *

Необязательный указатель на UINT32. Если значение NULL передается для параметра length, оно игнорируется. Если length является допустимым указателем на UINT32, а строка является допустимым HSTRING, то при успешном завершении функция устанавливает значение, указываемое по длине , на число символов Юникода в резервном буфере для строки (включая внедренные символы NULL, но исключая завершающий null). Если длина является допустимым указателем на UINT32, а строка имеет значение NULL, то значение, указываемое по длине , равно 0.

Возвращаемое значение

Тип: PCWSTR

Указатель на буфер, предоставляющий резервное хранилище для строки, или пустую строку, если строка имеет значение NULL или пустая строка.

Комментарии

Используйте функцию WindowsGetStringRawBuffer , чтобы получить указатель на резервный буфер HSTRING.

Не изменяйте содержимое буфера— HSTRING должен быть неизменяемым.

Требования