Função SnmpFreeEntity (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 SnmpFreeEntity libera recursos associados a uma entidade de gerenciamento SNMP.
Sintaxe
SNMPAPI_STATUS SNMPAPI_CALL SnmpFreeEntity(
[in] HSNMP_ENTITY entity
);
Parâmetros
[in] entity
Manipule para a entidade de gerenciamento SNMP que terá seus recursos liberados.
Retornar valor
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 de entidade é inválido. |
|
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 usando a função WinSNMP que corresponde ao recurso. Por exemplo, os aplicativos devem chamar a função SnmpFreeEntity para liberar recursos alocados por uma chamada para a função SnmpStrToEntity . 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
| Requisito | Valor |
|---|---|
| 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 |