SnmpMgrRequest, fonction (mgmtapi.h)

Article
08/24/2023

[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. Utilisez plutôt Windows Remote Management, qui est l’implémentation Microsoft de WS-Man.]

La fonction SnmpMgrRequest demande que l’opération spécifiée soit effectuée avec l’agent spécifié. Cette fonction est un élément de l’API de gestion SNMP.

Syntaxe

SNMPAPI SNMP_FUNC_TYPE SnmpMgrRequest(
  [in]      LPSNMP_MGR_SESSION session,
  [in]      BYTE               requestType,
  [in, out] RFC1157VarBindList *variableBindings,
  [out]     AsnInteger         *errorStatus,
  [out]     AsnInteger         *errorIndex
);

Paramètres

[in] session

Pointeur vers une structure interne qui spécifie la session qui exécutera la requête.

Les applications ne doivent pas spécifier le pointeur LPSNMP_MGR_SESSION retourné par cette fonction dans un thread différent. Vous pouvez spécifier un pointeur retourné par SnmpMgrOpen, mais uniquement si les appels à SnmpMgrOpen et SnmpMgrRequest proviennent du contexte du même thread.

[in] requestType

Spécifie le type de requête SNMP. Ce paramètre peut être l’une des valeurs suivantes définies par SNMPv1.

Valeur	Signification
SNMP_PDU_GET	Récupérez la ou les valeurs des variables spécifiées.
SNMP_PDU_GETNEXT	Récupérez la ou les valeurs du successeur lexicographique de la variable spécifiée.
SNMP_PDU_SET	Écrivez une valeur dans une variable spécifique.

Notez que les types de requêtes PDU ont été renommés. Pour plus d’informations, consultez Types de variables SNMP et Types PDU de requête.

[in, out] variableBindings

Pointeur vers la liste des liaisons de variables.

Note Le tableau SnmpVarBind pointé par la structure SnmpVarBindList doit être alloué à l’aide de la fonction SnmpUtilMemAlloc .

[out] errorStatus

Pointeur vers une variable dans laquelle l’erreur status résultat sera retourné. Ce paramètre peut être l’une des valeurs suivantes définies par SNMPv1.

Valeur	Signification
SNMP_ERRORSTATUS_NOERROR	L’agent signale qu’aucune erreur ne s’est produite pendant la transmission.
SNMP_ERRORSTATUS_TOOBIG	L’agent n’a pas pu placer les résultats de l’opération demandée dans un seul message SNMP.
SNMP_ERRORSTATUS_NOSUCHNAME	L’opération demandée a identifié une variable inconnue.
SNMP_ERRORSTATUS_BADVALUE	L’opération demandée a tenté de modifier une variable, mais elle a spécifié une erreur de syntaxe ou de valeur.
SNMP_ERRORSTATUS_READONLY	L’opération demandée a tenté de modifier une variable qui n’était pas autorisée à changer en fonction du profil de la communauté de la variable.
SNMP_ERRORSTATUS_GENERR	Une erreur autre que l’une de celles répertoriées ici s’est produite pendant l’opération demandée.

[out] errorIndex

Pointeur vers une variable dans laquelle le résultat de l’index d’erreur est retourné.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est NULL. Pour obtenir des informations d’erreur étendues, appelez GetLastError, qui peut retourner l’un des codes d’erreur suivants.

Code de retour	Description
SNMP_MGMTAPI_TIMEOUT	La requête a expiré.
SNMP_MGMTAPI_SELECT_FDERRORS	Descripteurs de fichier d’erreur inattendus indiqués par la fonction de sélection Windows Sockets.

Remarques

Les nouvelles tentatives et les délais d’attente sont fournis à la fonction SnmpMgrOpen . Chaque variable de la liste des liaisons de variables doit être initialisée pour taper ASN_NULL pour les requêtes Get et Get Next.

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	mgmtapi.h
Bibliothèque	Mgmtapi.lib
DLL	Mgmtapi.dll

Voir aussi

Fonctions SNMP

Vue d’ensemble du protocole SNMP (Simple Network Management Protocol)

SnmpMgrClose

SnmpMgrOpen

Partager via