Função SnmpMgrStrToOid (mgmtapi.h)
[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 |