Partager via


MÉTHODE ISNMP ::GetAsByte

La GetAsByte méthode permet à une page Web ASP d’obtenir la valeur identifiée par un OID SNMP et de convertir la valeur en entier non signé.

Syntaxe

HRESULT GetAsByte(
  [in]  BSTR  bstrOID,
  [out] PUINT puValue
);

Paramètres

bstrOID [in]
Valeur BSTR fournie par l’appelant qui contient l’OID SNMP.

puValue [out]
Pointeur fourni par l’appelant vers un emplacement qui reçoit la valeur entière non signée.

Valeur retournée

Cette méthode retourne l’une des valeurs du tableau suivant.

Code de retour Description
S_OK L’opération a réussi.
E_FAIL La méthode ISNMP ::Open n’a pas été appelée.
E_INVALIDARG L’OID SNMP spécifié n’est pas valide.
E_OUTOFMEMORY Mémoire insuffisante.

Exemple VBScript

Cette méthode appelle la fonction SnmpMgrRequest pour récupérer la valeur identifiée par un OID SNMP. Avant que la méthode passe la valeur à l’appelant, elle convertit l’appelant en entier non signé. Pour plus d’informations sur SnmpMgrRequest, consultez la documentation du Kit de développement logiciel (SDK) Windows.

Pour les types de données suivants, la ISNMP::GetAsByte méthode convertit la valeur scalaire identifiée par l’OID SNMP en une valeur entière non signée équivalente, que l’appelant reçoit :

  • ASN_INTEGER

  • ASN_RFC1155_COUNTER

  • ASN_RFC1155_GAUGE

  • ASN_RFC1155_TIMETICKS

  • ASN_UNSIGNED32

Pour les types de données suivants, si la taille de la valeur identifiée par l’OID SNMP ne dépasse pas deux octets, la méthode emballe les éléments de début de la chaîne, du tableau ou de la valeur opaque dans la valeur entière non signée que l’appelant reçoit :

  • ASN_BITS

  • ASN_OCTETSTRING

  • ASN_RFC1155_OPAQUE

  • ASN_SEQUENCE

Actuellement, la méthode ne prend pas en charge les conversions à partir de types de données autres que ceux des listes précédentes. Pour plus d’informations sur ces types de données, consultez la description de l’API gestion SNMP dans la documentation du Kit de développement logiciel (SDK) Windows.

La méthode ISNMP ::Open doit être appelée avant que la ISNMP::GetAsByte méthode puisse être appelée.

Dim StrIP, strCommunity, objSNMP, OIDValue
strIP = Session("MS_IPaddress")
strCommunity = Session ("MS_Community")
Set objSNMP = Server.CreateObject("OlePrn.OleSNMP")
objSNMP.Open strIP, strCommunity, 2, 1000
OIDValue = objSNMP.GetAsByte ("25.3.5.1.2")

Configuration requise

Plateforme cible : Bureau

En-tête: Olesnmp.h

Voir aussi

ISNMP ::Open