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 |
|---|---|
|
A função SnmpStartup não foi concluída com êxito. |
|
Ocorreu um erro durante a alocação de memória. |
|
O identificador de sessão é inválido. |
|
O identificador de PDU é inválido. |
|
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 |