Função WindowsCreateString (winstring.h)

Cria um novo HSTRING com base na cadeia de caracteres de origem especificada.

Sintaxe

HRESULT WindowsCreateString(
  PCNZWCH sourceString,
  UINT32  length,
  HSTRING *string
);

Parâmetros

sourceString

Tipo: [in, opcional] LPCWSTR

Uma cadeia de caracteres terminada em nulo a ser usada como a origem para o novo HSTRING. Para criar uma cadeia de caracteres nova, vazia ou NULL , passe NULL para sourceString e 0 para comprimento.

length

Tipo: [in] UINT32

O comprimento de sourceString, em caracteres Unicode. Deve ser 0 se sourceString for NULL.

string

Tipo: [out] HSTRING*

Um ponteiro para o HSTRING recém-criado ou NULL se ocorrer um erro. Qualquer conteúdo existente na cadeia de caracteres é substituído. O HSTRING é um tipo de identificador padrão.

Retornar valor

Tipo: HRESULT

Essa função pode retornar um desses valores.

Comentários

Use a função WindowsCreateString para alocar um novo HSTRING. O Windows Runtime copia a cadeia de caracteres para o buffer de backup do novo HSTRING e gerencia o tempo de vida do buffer usando uma contagem de referência. Chame a função WindowsCreateStringReference para criar uma cadeia de caracteres de passagem rápida, que usa uma cadeia de caracteres existente sem copiá-la.

Chame a função WindowsDeleteString para desalocar o HSTRING. Cada chamada para a função WindowsCreateString deve ser correspondida por uma chamada para WindowsDeleteString.

Para criar uma cadeia de caracteres nova, vazia ou NULL , passe NULL para sourceString e 0 para comprimento.

Se sourceString tiver caracteres nulos inseridos, a função WindowsCreateString copiará todos os caracteres para o caractere nulo de terminação.

Requisitos

Confira também

WindowsCreateStringReference

WindowsDeleteString