共用方式為


IRTC::Configure 方法

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

語法

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

參數

hConfigurationBlob [in]

呼叫端所設定之 BLOB 的控制碼。

hErrorBlob [out]

包含其他錯誤資料的錯誤 BLOB 控制碼。

傳回值

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

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

傳回碼 描述
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
找到 BLOB 類別區段,但無法瞭解。
NMERR_UNKNOWN_TAG
找到 BLOB 標籤區段,但無法瞭解。
NMERR_BLOB_CONVERSION_ERROR
BLOB 已損毀。
NMERR_ILLEGAL_TRIGGER
BLOB 的觸發程式部分已損毀。
NMERR_BLOB_STRING_INVALID
字串不是以 Null 結尾。

備註

您必須套用這個方法來重新開機已啟動、停止但未中斷連線的 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

另請參閱

IRTC

IRTC::Connect

網路監視器 BLOB