Funzione SnmpOidToStr (winsnmp.h)

Articolo
08/27/2023

[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 WinSNMP SnmpOidToStr converte la rappresentazione binaria interna di un identificatore di oggetto SNMP nel formato di stringa numerica punteggiata, ad esempio in "1.2.3.4.5.6".

Sintassi

SNMPAPI_STATUS SNMPAPI_CALL SnmpOidToStr(
  [in]  smiLPCOID srcOID,
  [in]  smiUINT32 size,
  [out] LPSTR     string
);

Parametri

[in] srcOID

Puntatore a una struttura smiOID con un identificatore di oggetto da convertire.

[in] size

Specifica le dimensioni, in byte, del buffer indicato dal parametro stringa . Per ulteriori informazioni, vedere la sezione Osservazioni successiva.

[out] string

Puntatore a un buffer per ricevere l'identificatore dell'oggetto stringa convertito che specifica l'entità di gestione SNMP.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è la lunghezza, in byte, della stringa che l'applicazione WinSNMP scrive nel parametro stringa . Il valore restituito include un byte di terminazione Null. Questo valore può essere minore o uguale al valore del parametro size , ma potrebbe non essere maggiore.

Se la funzione ha esito negativo, il valore restituito viene 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_SIZE_INVALID	Il parametro size non è valido. Questo parametro non può essere uguale a zero; deve indicare le dimensioni del buffer a cui punta il parametro stringa .
SNMPAPI_OID_INVALID	Il parametro srcOID non è valido. Per altre informazioni, vedere la sezione Osservazioni seguente.
SNMPAPI_OUTPUT_TRUNCATED	La lunghezza del buffer di output non è sufficiente.
SNMPAPI_OTHER_ERROR	Si è verificato un errore sconosciuto o non definito.

Commenti

È consigliabile specificare un'applicazione WinSNMP con il parametro size , un buffer stringa di lunghezza MAXOBJIDSTRSIZE (1408 byte). Ciò garantisce che il buffer di output sia sufficientemente grande da contenere la stringa convertita. Poiché la stringa convertita è in genere minore di MAXOBJIDSTRSIZE, l'applicazione WinSNMP può copiare la stringa convertita in un buffer più piccolo. L'applicazione può quindi riutilizzare o liberare la memoria allocata per il buffer iniziale. Per altre informazioni, vedere Concetti di Gestione dati 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

SnmpStrToOid

Funzioni WinSNMP

Panoramica dell'API WinSNMP

smiOID

Share via