Função SnmpFreeContext (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 SnmpFreeContext libera recursos associados a um contexto SNMP, que é um conjunto de recursos de objeto gerenciado.

Sintaxe

SNMPAPI_STATUS SNMPAPI_CALL SnmpFreeContext(
  [in] HSNMP_CONTEXT context
);

Parâmetros

[in] context

Manipule para o contexto SNMP que terá seus recursos liberados.

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_CONTEXT_INVALID	O parâmetro de contexto é inválido.
SNMPAPI_OTHER_ERROR	Ocorreu um erro desconhecido ou indefinido.

Comentários

Quando o aplicativo WinSNMP chama a função SnmpClose ou a função SnmpCleanup , a implementação do Microsoft WinSNMP libera todos os recursos alocados para a sessão WinSNMP. No entanto, é recomendável que o aplicativo WinSNMP libere recursos individuais com a função WinSNMP que corresponde ao recurso. Por exemplo, os aplicativos devem chamar a função SnmpFreeContext para liberar recursos alocados por uma chamada para a função SnmpStrToContext . Isso reduz a carga de trabalho da implementação e deve aprimorar o serviço da implementação para todos os aplicativos.

Para obter informações adicionais, consulte Conceitos de Gerenciamento de Dados 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