smiOCTETS 結構 (winsnmp.h)

發行項
03/04/2024

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

WinSNMP smiOCTETS 結構會將內容字串傳遞至多個 WinSNMP 函式。結構也會描述和接收編碼的SNMP訊息。

smiOCTETS 結構包含可變長度 SNMP 八位字串的指標。結構可以是 smiVALUE 結構的成員。

語法

typedef struct {
  smiUINT32 len;
  smiLPBYTE ptr;
} smiOCTETS, *smiLPOCTETS;

成員

len

指定不帶正負號的長整數值，指出 ptr 成員所指向八位字元串陣列中的位元組數目。

ptr

位元組陣列的指標，其中包含感興趣的八位字串。不需要 NULL 終止位元組。

備註

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

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

規格需求

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
標頭	winsnmp.h