Funzione SnmpStrToOid (winsnmp.h)

  • Articolo

[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 SnmpStrToOid WinSNMP converte il formato di stringa numerica tratteggiata di un identificatore di oggetto SNMP, ad esempio "1.2.3.4.5.6" nella relativa rappresentazione binaria interna.

Sintassi

SNMPAPI_STATUS SNMPAPI_CALL SnmpStrToOid(
  [in]  LPCSTR   string,
  [out] smiLPOID dstOID
);

Parametri

[in] string

Puntatore a una stringa di identificatore di oggetto con terminazione Null da convertire.

[out] dstOID

Puntatore a una struttura smiOID che riceve il valore convertito.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è il numero di subidentifier nell'identificatore dell'oggetto convertito. 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 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_OID_INVALID
 Il parametro stringa non è valido. Per altre informazioni, vedere la sezione Osservazioni seguente.
SNMPAPI_OTHER_ERROR
 Si è verificato un errore sconosciuto o non definito.

Commenti

L'applicazione WinSNMP deve chiamare la funzione SnmpFreeDescriptor per liberare le risorse allocate per il membro ptr della struttura smiOID a cui punta il parametro dstOID . In input SnmpFreeDescriptor ignora i membri di questa struttura smiOID . L'implementazione di Microsoft WinSNMP sovrascrive i membri smiOID se la funzione viene completata correttamente.

La funzione SnmpStrToOid ha esito negativo e restituisce il codice di errore SNMPAPI_OID_INVALID se il parametro stringa soddisfa una delle condizioni seguenti:

  • Non è con terminazione Null.
  • Non è la forma testuale di un identificatore di oggetto valido.
  • Lunghezza insufficiente; tutti gli identificatori di oggetto devono avere due identificatori secondari.
  • Supera MAXOBJIDSTRSIZE di 1408 byte.
Per altre informazioni, vedere WinSNMP Gestione dati Concepts and Freeing WinSNMP Descriptors .For additional information, see WinSNMP Gestione dati Concepts and Freeing WinSNMP Descriptors.

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