IStats::Configure 方法

Configure方法會提交擷取組態資訊。

語法

HRESULT STDMETHODCALLTYPE Configure(
  [in]  HBLOB hConfigurationBlob,
  [out] HBLOB hErrorBlob
);

參數

hConfigurationBlob [in]

處理呼叫端所設定的 BLOB。

hErrorBlob [out]

處理包含其他錯誤資訊的錯誤 BLOB。

傳回值

如果方法成功,傳回值會NMERR_SUCCESS。

如果方法失敗,傳回值就是下列其中一個錯誤碼:

傳回碼 描述
NMERR_BLOB_STRING_INVALID
字串不是以 Null 結尾。
NMERR_BLOB_NOT_INITIALIZED
尚未呼叫 CreateBlob 方法。
NMERR_INVALID_BLOB
指向的物件不是 BLOB。
NMERR_UPLEVEL_BLOB
BLOB 版本號碼不正確。
NMERR_BLOB_ENTRY_ALREADY_EXISTS
BLOB 專案已經存在。
NMERR_BLOB_ENTRY_DOES_NOT_EXIST
hConfigurationBlob參數指定的組態 BLOB 缺少執行此作業所需的專案。 查看 hErrorBlob 參數傳回的錯誤 BLOB,以判斷找不到哪個專案。
NMERR_AMBIGUOUS_SPECIFIER
BLOB 缺少擁有者或類別資訊。
NMERR_BLOB_OWNER_NOT_FOUND
找不到 BLOB 的擁有者區段。
NMERR_BLOB_CATEGORY_NOT_FOUND
找不到 BLOB 的 [類別] 區段。
NMERR_UNKNOWN_CATEGORY
找到類別資訊但無法理解。
NMERR_UNKNOWN_TAG
找到標記資訊但無法理解。
NMERR_BLOB_CONVERSION_ERROR
BLOB 已損毀。
NMERR_ILLEGAL_TRIGGER
BLOB 的觸發程式部分已損毀。

備註

您必須套用這個方法來重新開機已啟動、停止但未中斷連線的 NPP。

hErrorBlob傳回的錯誤 BLOB 包含網路監視器無法瞭解或找不到hConfigurationBlob參數中指定的組態 BLOB 的專案。 傳回的錯誤 BLOB 包含應用程式可用於疑難排解的錯誤資訊。 例如,如果傳回NMERR_BLOB_ENTRY_DOES_NOT_EXIST,傳回的錯誤 BLOB 中會包含網路監視器找不到的專案。

規格需求

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

另請參閱

IStats

ISTATS::連線

網路監視器 BLOB