smiOID 結構 (winsnmp.h)

[SNMP 可用於需求一節中指定的作業系統。它在後續版本中可能會變更或無法使用。請改用 Windows 遠端系統管理，這是 WS-Man 的 Microsoft 實作。

WinSNMP smiOID 結構會將物件識別碼傳遞至多個 WinSNMP 函式。結構也會在對 SnmpGetVb 函式的呼叫中接收變數系結專案的變數名稱。

smiOID結構包含具名物件之 subidentifiers 之可變長度陣列的指標。結構可以是 smiVALUE 結構的成員。

語法

typedef struct {
  smiUINT32   len;
  smiLPUINT32 ptr;
} smiOID, *smiLPOID;

len

指定不帶正負號的長整數值，這個值表示 ptr 成員所指向之陣列中的元素數目。

ptr

不帶正負號長整數陣列的指標，表示物件識別碼的子識別碼。

在 smiOID 結構中， ptr 成員所指向的陣列格式是每個陣列元素的一個子識別碼。例如，字串「1.3.6.1」會是四個元素 {1,3,6,1} 的陣列。

Microsoft WinSNMP 實作會配置並解除配置所有輸出 smiOID 結構的記憶體。 WinSNMP 應用程式不應該釋放實作為smiOID結構ptr成員配置的記憶體。相反地，應用程式必須呼叫 SnmpFreeDescriptor 函式以釋放記憶體。

由於 WinSNMP 應用程式會為具有可變長度的輸入描述元物件配置記憶體，因此必須釋放該記憶體。如需詳細資訊，請參閱WinSNMP 資料管理概念。