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

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

Синтаксис

PCWSTR WindowsGetStringRawBuffer(
  HSTRING string,
  UINT32  *length
);

Параметры

string

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

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

length

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

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

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

Тип: PCWSTR

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

Замечания

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

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

Требования