Compartilhar via

Função SnmpUtilIdsToA (snmp.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 SnmpUtilIdsToA converte um OID (identificador de objeto) em uma cadeia de caracteres terminada em nulo. Essa função é um elemento da API do Utilitário SNMP.

Sintaxe

LPSTR SNMP_FUNC_TYPE SnmpUtilIdsToA(
  [in] UINT *Ids,
  [in] UINT IdLength
);

Parâmetros

[in] Ids

Ponteiro para uma matriz de inteiros sem sinal. A matriz contém a sequência de números que o OID contém. O parâmetro IdLength especifica o comprimento da matriz.

Para obter mais informações, consulte as seções Valores retornados e Comentários a seguir.

[in] IdLength

Especifica o número de elementos na matriz apontada pelo parâmetro Ids .

Retornar valor

A função retorna uma cadeia de caracteres terminada em nulo que contém a representação de cadeia de caracteres da matriz de números apontada pelo parâmetro Ids . A cadeia de caracteres contém uma sequência de números separados por períodos ('.'); por exemplo, 1.3.6.1.4.1.311.

Se o parâmetro Ids for nulo ou se o parâmetro IdLength especificar zero, a função retornará a cadeia de caracteres "<null oid>".

O comprimento máximo da cadeia de caracteres retornada é de 256 caracteres. Se o comprimento da cadeia de caracteres exceder 256 caracteres, a cadeia de caracteres será truncada e terminada com uma sequência de três períodos ('...').

Comentários

A função SnmpUtilIdsToA pode ajudar na depuração de aplicativos SNMP.

Observe que as seguintes restrições de memória se aplicam quando você chama SnmpUtilIdsToA:

  • O parâmetro Ids deve apontar para um bloco de memória válido de pelo menos inteiros IdLength ou a chamada de função resulta em uma exceção de violação de acesso.
  • A cadeia de caracteres retornada por SnmpUtilIdsToA reside na memória alocada pela API do Utilitário SNMP. O aplicativo não deve fazer nenhuma suposição sobre a alocação de memória. Os dados têm a garantia de serem válidos até que você chame SnmpUtilIdsToA novamente, portanto, antes de chamar a função novamente, você deve copiar os dados para outro local.

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 snmp.h
Biblioteca Snmpapi.lib
DLL Snmpapi.dll

Confira também

Funções SNMP

Visão geral do Protocolo SNMP

SnmpUtilOidToA