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

Confira também

WindowsCreateString

WindowsCreateStringReference