Função SnmpFreeVbl (winsnmp.h)
[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 |
|---|---|
|
A função SnmpStartup não foi concluída com êxito. |
|
Ocorreu um erro durante a alocação de memória. |
|
O parâmetro vbl é inválido. |
|
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 |