Função SnmpFreePdu (winsnmp.h)

Artigo
03/13/2024

[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
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_PDU_INVALID	O identificador de PDU é inválido.
SNMPAPI_OTHER_ERROR	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