Funzione SnmpStrToOid (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 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 |
|---|---|
|
La funzione SnmpStartup non è stata completata correttamente. |
|
Errore durante l'allocazione della memoria. |
|
Il parametro stringa non è valido. Per altre informazioni, vedere la sezione Osservazioni seguente. |
|
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.
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 |