Funzione SnmpDuplicatePdu (winsnmp.h)

[SNMP è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. È possibile che in versioni successive sia stata modificata o non sia più disponibile. Usare invece Gestione remota Windows, ovvero l'implementazione Microsoft di WS-Man.

La funzione SnmpDuplicatePdudu di WinSNMP duplica l'unità dati del protocollo SNMP (PDU) identificata dal parametro PDU , allocando qualsiasi memoria necessaria per il PDU duplicato.

Sintassi

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

Parametri

[in] session

Gestire la sessione WinSNMP.

[in] PDU

Gestire l'oggetto PDU per duplicare. La funzione SnmpDuplicatePdu fornisce un handle univoco per ogni PDU all'interno dell'applicazione chiamante.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un handle che identifica il nuovo PDU duplicato.

Se la funzione ha esito negativo, il valore restituito è SNMPAPI_FAILURE. Per ottenere informazioni sull'errore estese, chiamare SnmpGetLastError. La funzione SnmpGetLastError può restituire uno degli errori seguenti.

Codice restituito	Descrizione
SNMPAPI_NOT_INITIALIZED	La funzione SnmpStartup non è stata completata correttamente.
SNMPAPI_ALLOC_ERROR	Errore durante l'allocazione della memoria.
SNMPAPI_SESSION_INVALID	L'handle di sessione non è valido.
SNMPAPI_PDU_INVALID	L'handle PDU non è valido.
SNMPAPI_OTHER_ERROR	Si è verificato un errore sconosciuto o non definito.

Commenti

Per rilasciare le risorse allocate dalla funzione SnmpDuplicatePdu per una nuova PDU, un'applicazione WinSNMP deve chiamare la funzione SnmpFreePdu .

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winsnmp.h
Libreria	Wsnmp32.lib
DLL	Wsnmp32.dll

Vedi anche

SnmpFreePdu

SnmpGetPduData

Funzioni WinSNMP

Panoramica dell'API WinSNMP