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 |
|---|---|
|
La funzione SnmpStartup non è stata completata correttamente. |
|
Errore durante l'allocazione della memoria. |
|
L'handle di sessione non è valido. |
|
L'handle PDU non è valido. |
|
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 |