Compartilhar via

Função WindowsGetStringRawBuffer (winstring.h)

  • Artigo

Recupera o buffer de backup para a 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 para comprimento, ele será ignorado. Se length 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 suporte para cadeia de caracteres (incluindo caracteres nulos inseridos, mas excluindo o nulo de terminação). Se length for um ponteiro válido para um UINT32e string for NULL, o valor apontado por length será definido como 0.

Retornar valor

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.

Comentários

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

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

Requisitos

   
Cliente mínimo com suporte Windows 8 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2012 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho winstring.h