Função WindowsDeleteString (winstring.h)

Diminui a contagem de referência de um buffer de cadeia de caracteres.

Sintaxe

HRESULT WindowsDeleteString(
  HSTRING string
);

Parâmetros

string

Tipo: [in] HSTRING

A cadeia de caracteres a ser excluída. Se string for uma cadeia de caracteres de passagem rápida criada pelo WindowsCreateStringReference ou se a cadeia de caracteres for NULL ou vazia, nenhuma ação será tomada e S_OK será retornado.

Valor retornado

Tipo: HRESULT

Essa função sempre retorna S_OK.

Comentários

Use a função WindowsDeleteString para desalocar um HSTRING. Chamar WindowsDeleteString diminui a contagem de referência do buffer de backup e, se a contagem de referência atingir 0, o Windows Runtime desalocará o buffer.

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

Confira também

WindowsCreateString

WindowsCreateStringReference