Compartilhar via

Função SnmpMgrStrToOid (mgmtapi.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 SnmpMgrStrToOid converte o formato de cadeia de caracteres de um identificador de objeto em sua estrutura de identificador de objeto interno. Essa função é um elemento da API de Gerenciamento SNMP.

Sintaxe

BOOL SNMP_FUNC_TYPE SnmpMgrStrToOid(
  [in]  LPSTR               string,
  [out] AsnObjectIdentifier *oid
);

Parâmetros

[in] string

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

[out] oid

Ponteiro para uma variável de identificador de objeto para receber o valor convertido.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero.

Comentários

Se a função for bem-sucedida, chame a função SnmpUtilOidFree para liberar a memória alocada para o identificador de objeto convertido.

Se um aplicativo passar um identificador de objeto válido para SnmpMgrStrToOid, ainda não for possível obter a variável solicitada, a sintaxe do grupo do sistema e do identificador de objeto estará incorreta. Isso ocorre porque SnmpMgrStrToOid pressupõe que o identificador de objeto esteja no MIB da Internet da subárvore de gerenciamento.

Você sempre deve preceder o identificador de objeto com um ponto (.) para obter o grupo de sistema correto (por exemplo, ".1.3.6.1.2.1.1"). Se um aplicativo passar a variável "1.3.6.1.2.1.1", SnmpMgrStrToOid não poderá interpretar o identificador de objeto corretamente.

Requisitos

Requisito Valor
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 mgmtapi.h
Biblioteca Mgmtapi.lib
DLL Mgmtapi.dll

Confira também

Funções SNMP

Visão geral do Protocolo SNMP

SnmpMgrOidToStr

SnmpUtilOidFree