共用方式為

IESP：：Configure 方法

  • 發行項

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

語法

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

參數

hConfigurationBlob [in]

處理呼叫端所設定的 BLOB。

hErrorBlob [out]

處理包含其他錯誤資訊的錯誤 BLOB。 如需錯誤 BLOB 內容的相關資訊，請參閱本主題中的一節。

傳回值

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

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

傳回碼 描述
NMERR_NOT_CONNECTED
 NPP 未連線到網路。
NMERR_NOT_ESP
 NPP 會連線到網路，但未使用 IESP：：Connect 方法。
NMERR_CAPTURING
 NPP 報告擷取會話已啟動。
NMERR_ILLEGAL_TRIGGER
 組態 BLOB 的觸發程式部分已損毀。
NMERR_BLOB_ENTRY_DOES_NOT_EXIST
 hConfigurationBlob指定的組態 BLOB 缺少執行此作業所需的專案。 查看 hErrorBlob 傳回的錯誤 BLOB，以判斷找不到哪個專案。
NMERR_BLOB_CONVERSION_ERROR
 BLOB 已損毀。
NMERR_BLOB_NOT_INITIALIZED
 尚未呼叫 CreateBlob 方法。
NMERR_INVALID_BLOB
 指向的物件不是 BLOB。
NMERR_BLOB_STRING_INVALID
 字串不是以 Null 結尾。
NMERR_UPLEVEL_BLOB
 BLOB 版本號碼不正確。
NMERR_OUT_OF_MEMORY
 沒有可用的記憶體。 關閉視窗以釋放資源。
NMERR_TIMEOUT
 要求已逾時。

備註

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