Função SnmpDuplicatePdu (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 SnmpDuplicatePdu duplica a PDU (unidade de dados de protocolo SNMP) que o parâmetro PDU identifica, alocando qualquer memória necessária para a PDU duplicada.

Sintaxe

HSNMP_PDU SNMPAPI_CALL SnmpDuplicatePdu(
  [in] HSNMP_SESSION session,
  [in] HSNMP_PDU     PDU
);

Parâmetros

[in] session

Manipule para a sessão WinSNMP.

[in] PDU

Manipule para a PDU a ser duplicada. A função SnmpDuplicatePdu fornece um identificador exclusivo para cada PDU dentro do aplicativo de chamada.

Retornar valor

Se a função for bem-sucedida, o valor retornado será um identificador que identifica a nova PDU duplicada.

Se a função falhar, o valor retornado será SNMPAPI_FAILURE. Para obter informações de erro estendidas, chame SnmpGetLastError. 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_SESSION_INVALID	O identificador de sessão é inválido.
SNMPAPI_PDU_INVALID	O identificador de PDU é inválido.
SNMPAPI_OTHER_ERROR	Ocorreu um erro desconhecido ou indefinido.

Comentários

Para liberar recursos alocados pela função SnmpDuplicatePdu para uma nova PDU, um aplicativo WinSNMP deve chamar a função SnmpFreePdu .

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

Confira também

SnmpFreePdu

SnmpGetPduData

Funções WinSNMP

Visão geral da API do WinSNMP