IStats：：Connect 方法

Connect方法會使用指定的 NIC 將 NPP 連線到網路，並提供連線的組態資訊。

語法

HRESULT STDMETHODCALLTYPE Connect(
  [in]  HBLOB  hInputBlob,
  [in]  LPVOID StatusCallbackProc,
  [in]  LPVOID UserContext,
  [out] HBLOB  hErrorBlob
);

參數

hInputBlob [in]

BLOB 的控制碼，指定 NPP 所連線的 NIC，以及該連線的組態資訊。

StatusCallbackProc [in]

使用者回呼函式的位址，它會接收狀態更新，例如觸發程式。 如果未使用回呼函式，請將此參數和 UserCoNtext 參數設定為 Null。

UserCoNtext [in]

呼叫使用者的回呼函式時所傳遞的值。 此參數的值通常是 HWND 或 'this' 指標。 如果未指定回呼函式，請將此參數和 StatusCallbackProc 參數設定為 Null。

hErrorBlob [out]

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

傳回值

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

如果方法失敗，則傳回值為下列其中一個錯誤碼， (包括內部 IStats：：Configure 呼叫所傳回的錯誤) ：

傳回碼	描述
NMERR_ALREADY_CONNECTED	這個 NPP COM 物件的實例已經連線到網路。
NMERR_BLOB_CONVERSION_ERROR	組態 BLOB 已損毀。 IStats：：Configure呼叫會產生此錯誤。
NMERR_BLOB_ENTRY_DOES_NOT_EXIST	hInputBlob參數指定的輸入 BLOB 缺少執行這項作業所需的專案。 此錯誤可能是由 IStats：：Connect 或 IStats：：Configure 呼叫所產生。 查看 hErrorBlob 傳回的錯誤 BLOB，以判斷找不到哪個專案。
NMERR_BLOB_NOT_INITIALIZED	尚未呼叫 CreateBlob 函式。 IStats：：Configure呼叫會產生此錯誤。
NMERR_BLOB_STRING_INVALID	字串不是以 Null 結尾。 IStats：：Configure呼叫會產生此錯誤。
NMERR_ILLEGAL_TRIGGER	輸入 BLOB 的觸發程式部分已損毀。 IStats：：Configure呼叫會產生此錯誤。
NMERR_INVALID_BLOB	hInputBlob中指定的物件不是 BLOB。 IStats：：Configure呼叫會產生此錯誤。
NMERR_NO_DEFAULT_CAPTURE_DIRECTORY	未在登錄中設定預設擷取目錄。 若要設定擷取目錄，請使用下列路徑。 HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\nm\Parameters\CapturePath
NMERR_OUT_OF_MEMORY	執行此作業所需的記憶體無法使用。 IStats：：Configure呼叫會產生此錯誤。
NMERR_TIMEOUT	要求已逾時。 IStats：：Configure 呼叫會產生此錯誤。
NMERR_UPLEVEL_BLOB	hInputBlob中指定的 BLOB 版本號碼不正確。 IStats：：Configure呼叫會產生此錯誤。

備註

呼叫Connect方法時，網路監視器會使用hInputBlob參數所提供的 BLOB 自動呼叫IStats：：Configure方法。 請注意， IStats：：Configure 呼叫所傳回的任何錯誤碼會傳回 ，並由 IStats：：Connect 呼叫傳回。

您必須先呼叫這個方法，才能開始擷取畫面格。 請注意，當您使用此方法連線到網路時，必須繼續使用 IStats 介面來擷取畫面格。

您可以呼叫GetNPPBlob、GetNPPBlobTable和SelectNPPBlobFromTable方法來取得hInputBlob所指定的輸入 BLOB。

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

如需下列資訊	請參閱
取得代表網路介面卡的輸入 BLOB	選取網路介面卡

規格需求

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

另請參閱

IStats

IStats：：Configure

IStats：:D isconnect

網路監視器 BLOB