Funzione SnmpMgrStrToOid (mgmtapi.h)

Articolo
03/15/2023

[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 SnmpMgrStrToOid converte il formato stringa di un identificatore di oggetto nella struttura dell'identificatore di oggetto interno. Questa funzione è un elemento dell'API di gestione SNMP.

Sintassi

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

Parametri

[in] string

Puntatore a una stringa con terminazione Null da convertire.

[out] oid

Puntatore a una variabile dell'identificatore di oggetto per ricevere il valore convertito.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero.

Commenti

Se la funzione ha esito positivo, chiamare la funzione SnmpUtilOidFree per liberare la memoria allocata per l'identificatore di oggetto convertito.

Se un'applicazione passa un identificatore di oggetto valido a SnmpMgrStrToOid, ma non è in grado di ottenere la variabile richiesta, la sintassi del gruppo di sistema e dell'identificatore di oggetto non è corretta. Ciò si verifica perché SnmpMgrStrToOid presuppone che l'identificatore dell'oggetto si trova sotto internet MIB del sottoalbero di gestione.

È sempre necessario precedere l'identificatore dell'oggetto con un punto (.) per ottenere il gruppo di sistema corretto (ad esempio, ".1.3.6.1.2.1.1"). Se un'applicazione passa la variabile "1.3.6.1.2.1.1", SnmpMgrStrToOid non può interpretare correttamente l'identificatore dell'oggetto.

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	mgmtapi.h
Libreria	Mgmtapi.lib
DLL	Mgmtapi.dll

Vedi anche

Funzioni SNMP

Panoramica del protocollo Simple Network Management Protocol (SNMP)

SnmpMgrOidToStr

SnmpUtilOidFree

Condividi tramite