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 專業版 [僅限傳統型應用程式]
最低支援的伺服器
 Windows 2000 Server [僅限傳統型應用程式]
標頭
Netmon.h
DLL
Ndisnpp.dll;
Rmtnpp.dll

另請參閱

IStats

ISTATS：：Connect

網路監視器 BLOB