Funzione SnmpOidCompare (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 WinSNMP SnmpOidCompare lexicographically confronta due identificatori di oggetto SNMP, fino alla lunghezza specificata dal parametro maxlen .
Sintassi
SNMPAPI_STATUS SNMPAPI_CALL SnmpOidCompare(
[in] smiLPCOID xOID,
[in] smiLPCOID yOID,
[in] smiUINT32 maxlen,
[out] smiLPINT result
);
Parametri
[in] xOID
Puntatore al primo identificatore di oggetto smiOID da confrontare. La lunghezza dell'identificatore dell'oggetto può essere zero.
[in] yOID
Puntatore al secondo identificatore dell'oggetto smiOID da confrontare. La lunghezza dell'identificatore dell'oggetto può essere zero.
[in] maxlen
Se non è uguale a zero, specifica il numero di subidentifier da confrontare. Questo parametro deve essere minore di MAXOBJIDSIZE: 128 sottoidentifier, il numero massimo di componenti in un identificatore di oggetto. Per altre informazioni, vedere la sezione Osservazioni seguenti.
[out] result
Puntatore a una variabile integer per ricevere il risultato del confronto. La variabile può ricevere uno dei risultati seguenti.
| Risultato | Significato |
|---|---|
|
xOID è maggiore di yOID |
|
xOID è uguale a yOID |
|
xOID è minore di yOID |
Per altre condizioni di confronto, vedere la sezione Osservazioni seguenti.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è SNMPAPI_SUCCESS.
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 |
|---|---|
|
La funzione SnmpStartup non è stata completata correttamente. |
|
Errore durante l'allocazione della memoria. |
|
Uno o entrambi i parametri xOID e yOID non sono validi. |
|
Il parametro maxlen non è valido. La dimensione del parametro è maggiore di MAXOBJIDSIZE. |
|
Si è verificato un errore sconosciuto o non definito. |
Commenti
Un'applicazione WinSNMP può chiamare la funzione SnmpOidCompare per determinare se due identificatori di oggetto hanno prefissi comuni.
Se il parametro maxlen non è uguale a zero e non maggiore di MAXOBJIDSIZE, il valore di maxlen imposta il limite superiore per il numero di subidentifier da confrontare. Il numero massimo di sottoidentifier che la funzione SnmpOidCompare confronta le impostazioni predefinite a qualsiasi numero è il numero più piccolo, ovvero il parametro maxlen o il membro len di una delle strutture smiOID a cui puntano i parametri xOID e yOID .
Se il parametro maxlen è uguale a zero, il numero massimo di sottoidentifier che la funzione SnmpOidCompare confronta le impostazioni predefinite con il numero minore dei membri len delle due strutture smiOID .
Il valore del parametro risultato indicherà che xOID è uguale a yOID se le due strutture smiOID sono lexicograficamente uguali e si verifica uno dei seguenti:
- SnmpOidCompare confronta un numero massimo di sottoidentifier.
- SnmpOidCompare confronta il numero massimo di subidentifier e i membri len di entrambe le strutture smiOID sono uguali, ma minore del parametro maxlen .
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 |