Funzione SnmpOidCopy (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 SnmpOidCopy WinSNMP copia un identificatore di oggetto SNMP, allocando qualsiasi memoria necessaria per la copia.

Sintassi

SNMPAPI_STATUS SNMPAPI_CALL SnmpOidCopy(
  [in]  smiLPCOID srcOID,
  [out] smiLPOID  dstOID
);

Parametri

[in] srcOID

Puntatore a una struttura smiOID da copiare.

[out] dstOID

Puntatore a una struttura smiOID per ricevere una copia dell'identificatore dell'oggetto specificato dal parametro srcOID .

Valore restituito

Se la funzione ha esito positivo, il valore restituito è il numero di sottoidentifier nell'identificatore dell'oggetto copiato. Questo numero è anche il valore del membro len della struttura smiOID a cui punta il parametro dstOID .

Se la funzione ha esito negativo, il valore restituito è SNMPAPI_FAILURE. Per ottenere informazioni sull'errore estese, chiamare SnmpGetLastError specificando un valore NULL nel relativo parametro di sessione . 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_OID_INVALID	Il parametro srcOID non è valido.
SNMPAPI_OTHER_ERROR	Si è verificato un errore sconosciuto o non definito.

Commenti

In input, la funzione SnmpOidCopy ignora i membri della struttura smiOID a cui punta il parametro dstOID . L'implementazione di Microsoft WinSNMP sovrascrive i membri smiOID se la funzione viene completata correttamente.

L'applicazione WinSNMP deve chiamare la funzione SnmpFreeDescriptor per consentire all'implementazione di liberare risorse allocate per il membro ptr della struttura smiOID a cui punta il parametro dstOID . Per altre informazioni, vedere Concetti Gestione dati WinSNMP e descrittori WinSNMP.

Requisiti

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

SnmpFreeDescriptor

Funzioni WinSNMP

Panoramica dell'API WinSNMP

smiOID