Compartilhar via

Função SnmpStrToOid (winsnmp.h)

  • Artigo

[O SNMP está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele poderá ser alterado ou ficar indisponível em versões subsequentes. Em vez disso, use o Gerenciamento Remoto do Windows, que é a implementação da Microsoft do WS-Man.]

A função WinSNMP SnmpStrToOid converte o formato de cadeia de caracteres numérica pontilhada de um identificador de objeto SNMP, por exemplo, "1.2.3.4.5.6", em sua representação binária interna.

Sintaxe

SNMPAPI_STATUS SNMPAPI_CALL SnmpStrToOid(
  [in]  LPCSTR   string,
  [out] smiLPOID dstOID
);

Parâmetros

[in] string

Ponteiro para uma cadeia de caracteres de identificador de objeto terminada em nulo a ser convertida.

[out] dstOID

Ponteiro para uma estrutura smiOID que recebe o valor convertido.

Valor retornado

Se a função for bem-sucedida, o valor retornado será o número de subidentifiers no identificador de objeto convertido. Esse número também é o valor do membro len da estrutura smiOID apontada pelo parâmetro dstOID .

Se a função falhar, o valor retornado será SNMPAPI_FAILURE. Para obter informações de erro estendidas, chame SnmpGetLastError especificando um valor NULL em seu parâmetro de sessão . A função SnmpGetLastError pode retornar um dos erros a seguir.

Código de retorno Descrição
SNMPAPI_NOT_INITIALIZED
 A função SnmpStartup não foi concluída com êxito.
SNMPAPI_ALLOC_ERROR
 Ocorreu um erro durante a alocação de memória.
SNMPAPI_OID_INVALID
 O parâmetro de cadeia de caracteres é inválido. Para obter informações adicionais, consulte a seção Comentários a seguir.
SNMPAPI_OTHER_ERROR
 Ocorreu um erro desconhecido ou indefinido.

Comentários

O aplicativo WinSNMP deve chamar a função SnmpFreeDescriptor para liberar recursos alocados para o membro ptr da estrutura smiOID apontada pelo parâmetro dstOID . Na entrada, SnmpFreeDescriptor ignora os membros dessa estrutura smiOID . A implementação do Microsoft WinSNMP substituirá os membros smiOID se a função for concluída com êxito.

A função SnmpStrToOid falhará e retornará o código de erro SNMPAPI_OID_INVALID se o parâmetro de cadeia de caracteres atender a uma das seguintes condições:

  • Não foi encerrado em nulo.
  • Não é a forma textual de um identificador de objeto válido.
  • É insuficiente em comprimento; todos os identificadores de objeto devem ter dois subidentifiers.
  • Excede o MAXOBJIDSTRSIZE de 1408 bytes.
Para obter informações adicionais, consulte Conceitos de Gerenciamento de Dados WinSNMP e Liberando descritores WinSNMP.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winsnmp.h
Biblioteca Wsnmp32.lib
DLL Wsnmp32.dll

Confira também

SnmpFreeDescriptor

Funções WinSNMP

Visão geral da API do WinSNMP

smiOID