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.
| Código de retorno | Descrição |
|---|---|
|
O HSTRING foi criado com êxito. |
|
string é NULL. |
|
Falha ao alocar o novo HSTRING. |
|
sourceString é NULL e length é diferente de zero. |
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
| 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 |