Função SnmpUtilIdsToA (snmp.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 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 |