SnmpOidCompare, fonction (winsnmp.h)
[SNMP est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il sera peut-être modifié ou indisponible dans les versions ultérieures. Au lieu de cela, utilisez La gestion à distance Windows, qui est l’implémentation Microsoft de WS-Man.]
La fonction SnmpOidCompare WinSNMP compare lexicographiquement deux identificateurs d’objet SNMP, jusqu’à la longueur spécifiée par le paramètre maxlen .
Syntaxe
SNMPAPI_STATUS SNMPAPI_CALL SnmpOidCompare(
[in] smiLPCOID xOID,
[in] smiLPCOID yOID,
[in] smiUINT32 maxlen,
[out] smiLPINT result
);
Paramètres
[in] xOID
Pointeur vers le premier identificateur d’objet smiOID à comparer. La longueur de l’identificateur d’objet peut être égale à zéro.
[in] yOID
Pointeur vers le deuxième identificateur d’objet smiOID à comparer. La longueur de l’identificateur d’objet peut être égale à zéro.
[in] maxlen
S’il n’est pas égal à zéro, spécifie le nombre de sous-identificateurs à comparer. Ce paramètre doit être inférieur à MAXOBJIDSIZE : 128 sous-identificateurs, le nombre maximal de composants dans un identificateur d’objet. Pour plus d’informations, consultez la section Remarques suivante.
[out] result
Pointeur vers une variable entière pour recevoir le résultat de la comparaison. La variable peut recevoir l’un des résultats suivants.
Résultats | Signification |
---|---|
|
xOID est supérieur à yOID |
|
xOID est égal à yOID |
|
xOID est inférieur à yOID |
Pour obtenir des conditions de comparaison supplémentaires, consultez la section Remarques suivante.
Valeur retournée
Si la fonction réussit, la valeur de retour est SNMPAPI_SUCCESS.
Si la fonction échoue, la valeur de retour est SNMPAPI_FAILURE. Pour obtenir des informations d’erreur étendues, appelez SnmpGetLastError en spécifiant une valeur NULL dans son paramètre de session . La fonction SnmpGetLastError peut retourner l’une des erreurs suivantes.
Code de retour | Description |
---|---|
|
La fonction SnmpStartup ne s’est pas terminée correctement. |
|
Une erreur s’est produite lors de l’allocation de mémoire. |
|
L’un ou les deux paramètres xOID et yOID n’est pas valide. |
|
Le paramètre maxlen n’est pas valide. La taille du paramètre est supérieure à MAXOBJIDSIZE. |
|
Une erreur inconnue ou non définie s’est produite. |
Remarques
Une application WinSNMP peut appeler la fonction SnmpOidCompare pour déterminer si deux identificateurs d’objet ont des préfixes communs.
Si le paramètre maxlen n’est pas égal à zéro et n’est pas supérieur à MAXOBJIDSIZE, la valeur de maxlen définit la limite supérieure du nombre de sous-identificateurs à comparer. Nombre maximal de sous-identificateurs que la fonction SnmpOidCompare compare par défaut à celui qui correspond au plus petit nombre( le paramètre maxlen ou le membre len de l’une des structures smiOID pointées par les paramètres xOID et yOID .
Si le paramètre maxlen est égal à zéro, le nombre maximal de sous-identificateurs que la fonction SnmpOidCompare compare par défaut au nombre qui est le plus petit des membres len des deux structures smiOID .
La valeur du paramètre de résultat indique que xOID est égal à yOID si les deux structures smiOID sont égales au niveau lexicographique et si l’une des opérations suivantes se produit :
- SnmpOidCompare compare un nombre maximal de sous-identificateurs.
- SnmpOidCompare compare le nombre maximal de sous-identificateurs, et les membres len des deux structures smiOID sont égaux, mais inférieurs au paramètre maxlen .
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
Plateforme cible | Windows |
En-tête | winsnmp.h |
Bibliothèque | Wsnmp32.lib |
DLL | Wsnmp32.dll |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour