Funzione SnmpUtilIdsToA (snmp.h)

Articolo
03/02/2024

[SNMP è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. È possibile che in versioni successive sia stata modificata o non sia più disponibile. Usare invece Gestione remota Windows, ovvero l'implementazione Microsoft di WS-Man.

La funzione SnmpUtilIdsToA converte un identificatore di oggetto (OID) in una stringa con terminazione Null. Questa funzione è un elemento dell'API dell'utilità SNMP.

Sintassi

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

Parametri

[in] Ids

Puntatore a una matrice di interi senza segno. La matrice contiene la sequenza di numeri contenuti nell'OID. Il parametro IdLength specifica la lunghezza della matrice.

Per altre informazioni, vedere le sezioni Valori restituiti e Osservazioni seguenti.

[in] IdLength

Specifica il numero di elementi nella matrice a cui punta il parametro Ids .

Valore restituito

La funzione restituisce una stringa con terminazione Null che contiene la rappresentazione di stringa della matrice di numeri a cui punta il parametro Ids . La stringa contiene una sequenza di numeri separati da punti ('.'); ad esempio 1.3.6.1.4.1.311.

Se il parametro Ids è Null o se il parametro IdLength specifica zero, la funzione restituisce la stringa "<null oid>".

La lunghezza massima della stringa restituita è di 256 caratteri. Se la lunghezza della stringa supera i 256 caratteri, la stringa viene troncata e terminata con una sequenza di tre punti ('...').

Commenti

La funzione SnmpUtilIdsToA può essere utile per il debug delle applicazioni SNMP.

Si noti che quando si chiama SnmpUtilIdsToA si applicano le restrizioni di memoria seguenti:

Il parametro Ids deve puntare a un blocco di memoria valido di almeno numeri interi IdLength oppure la chiamata di funzione genera un'eccezione di violazione di accesso.
La stringa restituita da SnmpUtilIdsToA risiede nella memoria allocata dall'API dell'utilità SNMP. L'applicazione non deve fare ipotesi sull'allocazione di memoria. È garantito che i dati siano validi fino a quando non si chiama nuovamente SnmpUtilIdsToA , quindi prima di chiamare nuovamente la funzione è necessario copiare i dati in un'altra posizione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	snmp.h
Libreria	Snmpapi.lib
DLL	Snmpapi.dll

Vedi anche

Funzioni SNMP

Panoramica del protocollo Simple Network Management Protocol (SNMP)

SnmpUtilOidToA

Condividi tramite