Compartilhar via


Método ISNMP::GetAsByte

O GetAsByte método permite que uma página da Web ASP obtenha o valor identificado por um OID SNMP e converta o valor em um inteiro sem sinal.

Sintaxe

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

Parâmetros

bstrOID [in]
Um valor BSTR fornecido pelo chamador que contém o OID SNMP.

puValue [out]
Um ponteiro fornecido pelo chamador para um local que recebe o valor inteiro sem sinal.

Retornar valor

Esse método retorna um dos valores na tabela a seguir.

Código de retorno Descrição
S_OK A operação foi realizada com êxito.
E_FAIL O método ISNMP::Open não foi chamado.
E_INVALIDARG O OID SNMP especificado não é válido.
E_OUTOFMEMORY Sem memória.

Exemplo de VBScript

Esse método chama a função SnmpMgrRequest para recuperar o valor identificado por um OID SNMP. Antes que o método passe o valor para o chamador, ele converte o chamador em um inteiro sem sinal. Para obter mais informações sobre snmpMgrRequest, consulte a documentação do SDK do Windows.

Para os seguintes tipos de dados, o ISNMP::GetAsByte método converte o valor escalar identificado pelo OID SNMP em um valor inteiro sem sinal equivalente, que o chamador recebe:

  • ASN_INTEGER

  • ASN_RFC1155_COUNTER

  • ASN_RFC1155_GAUGE

  • ASN_RFC1155_TIMETICKS

  • ASN_UNSIGNED32

Para os tipos de dados a seguir, se o tamanho do valor identificado pelo OID SNMP não exceder dois bytes, o método empacotará os elementos inciais da cadeia de caracteres, matriz ou valor opaco no valor inteiro sem sinal que o chamador recebe:

  • ASN_BITS

  • ASN_OCTETSTRING

  • ASN_RFC1155_OPAQUE

  • ASN_SEQUENCE

Atualmente, o método não dá suporte a conversões de tipos de dados diferentes daqueles nas listas anteriores. Para obter mais informações sobre esses tipos de dados, consulte a descrição da API de Gerenciamento do SNMP na documentação do SDK do Windows.

O método ISNMP::Open deve ser chamado antes que o ISNMP::GetAsByte método possa ser chamado.

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")

Requisitos

Plataforma de destino: Desktop

Cabeçalho: Olesnmp.h

Confira também

ISNMP::Open