Função SnmpFreePdu (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 SnmpFreePdu libera recursos associados a uma PDU (unidade de dados de protocolo SNMP) criada pela função SnmpCreatePdu ou SnmpDuplicatePdu .
Sintaxe
SNMPAPI_STATUS SNMPAPI_CALL SnmpFreePdu(
[in] HSNMP_PDU PDU
);
Parâmetros
[in] PDU
Manipule para a PDU SNMP para liberar.
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 identificador de PDU é inválido. |
|
Ocorreu um erro desconhecido ou indefinido. |
Comentários
Se o aplicativo chamar a função SnmpClose ou SnmpCleanup , a implementação do Microsoft WinSNMP liberará todos os recursos alocados para a sessão WinSNMP. No entanto, é recomendável que o aplicativo libere recursos individuais com a função WinSNMP que corresponde ao recurso. Isso reduz a carga de trabalho da implementação e deve aprimorar o serviço da implementação para todos os aplicativos. O aplicativo deve usar a função SnmpFreeVbl para desalocar recursos de lista de associações variáveis. Para obter informações adicionais, consulte Conceitos de Gerenciamento de Dados WinSNMP.
Em WinSNMP, uma entrada de associação de variável existe somente dentro de uma lista de associações de variáveis, mesmo que a lista de associações de variáveis contenha apenas uma entrada.
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 |