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 a cadeia de caracteres 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á executada e S_OK será retornada.

Valor de retorno

Tipo: HRESULT

Essa função sempre retorna S_OK.

Observações

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

Requirements

Consulte também

windowsCreateString

WindowsCreateStringReference