Função WindowsGetStringRawBuffer (winstring.h)

Recupera o buffer de backup da cadeia de caracteres especificada.

Sintaxe

PCWSTR WindowsGetStringRawBuffer(
  HSTRING string,
  UINT32  *length
);

Parâmetros

string

Tipo: [in, opcional] HSTRING

Uma cadeia de caracteres opcional para a qual o buffer de backup deve ser recuperado. Pode ser NULL.

length

Tipo: [out, opcional] UINT32 *

Um ponteiro opcional para um UINT32. Se NULL for passado por comprimento, ele será ignorado. Se o comprimento for um ponteiro válido para um UINT32 e a cadeia de caracteres for um HSTRING válido, após a conclusão bem-sucedida, a função definirá o valor apontado por comprimento para o número de caracteres Unicode no buffer de backup para cadeia de caracteres (incluindo caracteres nulos inseridos, mas excluindo o nulo de terminação). Se o comprimento for um ponteiro válido para um UINT32 e a cadeia de caracteres for NULL, o valor apontado por comprimento será definido como 0.

Valor de retorno

Tipo: PCWSTR

Um ponteiro para o buffer que fornece o repositório de backup para cadeia de caracteres ou a cadeia de caracteres vazia se a cadeia de caracteres for NULL ou a cadeia de caracteres vazia.

Observações

Use a função WindowsGetStringRawBuffer para obter um ponteiro para o buffer de backup de um HSTRING.

Não altere o conteúdo do buffer– um HSTRING é necessário para ser imutável.

Requirements

Requirement	Value
Cliente mínimo suportado	Windows 8 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo compatível	Windows Server 2012 [aplicativos da área de trabalho | Aplicativos UWP]
da Plataforma de Destino	Windows
Header	winstring.h
Library	mincore.lib