Função SnmpFreeVbl (winsnmp.h)

Artigo
08/27/2023

[O SNMP está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele poderá ser alterado ou ficar indisponível em versões subsequentes. Em vez disso, use o Gerenciamento Remoto do Windows, que é a implementação da Microsoft do WS-Man.]

A função WinSNMP SnmpFreeVbl libera recursos associados a uma lista de associações de variáveis. Esses são recursos alocados anteriormente por uma chamada para a função SnmpCreateVbl ou a função SnmpDuplicateVbl em um aplicativo WinSNMP.

Sintaxe

SNMPAPI_STATUS SNMPAPI_CALL SnmpFreeVbl(
  [in] HSNMP_VBL vbl
);

Parâmetros

[in] vbl

Manipule para a lista de associações de variáveis a ser lançada.

Valor retornado

Se a função for bem-sucedida, o valor retornado será SNMPAPI_SUCCESS.

Se a função falhar, o valor retornado será SNMPAPI_FAILURE. Para obter informações de erro estendidas, chame SnmpGetLastError especificando um valor NULL em seu parâmetro de sessão . A função SnmpGetLastError pode retornar um dos erros a seguir.

Código de retorno	Descrição
SNMPAPI_NOT_INITIALIZED	A função SnmpStartup não foi concluída com êxito.
SNMPAPI_ALLOC_ERROR	Ocorreu um erro durante a alocação de memória.
SNMPAPI_VBL_INVALID	O parâmetro vbl é inválido.
SNMPAPI_OTHER_ERROR	Ocorreu um erro desconhecido ou indefinido.

Comentários

O aplicativo WinSNMP deve liberar os recursos associados a cada lista de associações de variáveis. Ele deve fazer isso correspondendo cada chamada às funções SnmpCreateVbl e SnmpDuplicateVbl com uma chamada correspondente à função SnmpFreeVbl . Para evitar vazamentos de memória, um aplicativo WinSNMP deve chamar SnmpFreeVbl antes de reutilizar o identificador para uma lista de associações de variáveis em uma chamada subsequente para SnmpCreateVbl ou SnmpDuplicateVbl.

Se o aplicativo chamar o SnmpClose ou a função SnmpCleanup , a implementação do Microsoft WinSNMP liberará todos os recursos alocados para a sessão WinSNMP. No entanto, mesmo que o aplicativo não reutilize um identificador de lista de associações de variáveis, é recomendável que o aplicativo libere recursos de associações de variáveis individuais com a função SnmpFreeVbl . Isso reduz a carga de trabalho da implementação e deve aprimorar seu serviço para todos os aplicativos. Para obter informações adicionais, consulte Conceitos de Gerenciamento de Dados do WinSNMP.

Requisitos


Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winsnmp.h
Biblioteca	Wsnmp32.lib
DLL	Wsnmp32.dll