IESP：：Connect 方法
Connect方法會使用指定的 NIC 將 NPP 連線到網路，並提供連線的組態資訊。
語法
HRESULT STDMETHODCALLTYPE Connect(
[in] HBLOB hInputBlob,
[in] DWORD StatusCallbackProc,
[in] DWORD UserContext,
[out] HBLOB hErrorBlob
);
參數
-
hInputBlob [in]
-
BLOB 的控制碼，指定 NPP 所連線的 NIC，以及該連線的組態資訊。
-
StatusCallbackProc [in]
-
使用者回呼函式的位址，它會接收狀態更新，例如觸發程式。 如果未使用回呼函式，請將此參數和 UserCoNtext 參數設定為 Null。
-
UserCoNtext [in]
-
呼叫使用者的回呼函式時所傳遞的值。 此參數的值通常是 HWND 或 'this' 指標。 如果未指定回呼函式，請將此參數和 StatusCallbackProc 參數設定為 Null。
-
hErrorBlob [out]
-
處理包含其他錯誤資訊的錯誤 BLOB。
傳回值
如果方法成功，傳回值會NMERR_SUCCESS。
如果方法失敗，傳回值為下列其中一個錯誤碼， (包括內部 IESP：：Configure 呼叫所傳回的錯誤) ：
| 傳回碼 | 描述 |
|---|---|
|
這個 NPP COM 物件的實例已經連線到網路。 |
|
組態 BLOB 已損毀。 此錯誤是由 IESP：：Configure 呼叫所產生。 |
|
hInputBlob參數指定的輸入 BLOB 缺少執行這項作業所需的專案。
IESP：：Connect或IESP：：Configure呼叫可能會產生此錯誤。 查看 hErrorBlob 傳回的錯誤 BLOB，以判斷找不到哪個專案。 |
|
尚未呼叫 CreateBlob 函式。 此錯誤是由 IESP：：Configure 呼叫所產生。 |
|
字串不是以 Null 結尾。 此錯誤是由 IESP：：Configure 呼叫所產生。 |
|
輸入 BLOB 的觸發程式部分已損毀。 此錯誤是由 IESP：：Configure 呼叫所產生。 |
|
hInputBlob中指定的物件不是 BLOB。 此錯誤是由 IESP：：Configure 呼叫所產生。 |
|
未在登錄中設定預設擷取目錄。 使用下列路徑來設定擷取目錄。 |
|
執行此作業所需的記憶體無法使用。 此錯誤是由 IESP：：Configure 呼叫所產生。 |
|
要求已逾時。此錯誤是由 IESP：：Configure 呼叫所產生。 |
|
hInputBlob中指定的 BLOB 版本號碼不正確。 此錯誤是由 IESP：：Configure 呼叫所產生。 |
備註
呼叫Connect方法時，網路監視器會使用hInputBlob參數所提供的 BLOB 自動呼叫IESP：：Configure。 請注意， 呼叫 IESP：：Configure 傳回的任何錯誤碼會傳回，並由 IESP：：Connect 呼叫傳回。
您必須先呼叫這個方法，才能開始擷取畫面格。 請注意，當您使用此方法連線到網路時，必須繼續使用 IESP 介面來擷取畫面格。
您可以呼叫GetNPPBlob、GetNPPBlobTable和SelectNPPBlobFromTable來取得hInputBlob所指定的輸入 BLOB。
hErrorBlob傳回的錯誤 BLOB 包含網路監視器無法瞭解或找不到hInputBlob中所指定輸入 BLOB 的專案。 傳回的錯誤 BLOB 包含應用程式可用於疑難排解的錯誤資訊。 例如，如果傳回NMERR_BLOB_ENTRY_DOES_NOT_EXIST，網路監視器找不到的專案就會包含在傳回的錯誤 BLOB 中。
| 如需下列資訊 | 請參閱 |
|---|---|
| 取得代表 NIC 的輸入 BLOB | 選取網路介面卡 |
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 |
Windows 2000 Server [僅限桌面應用程式] |
| 標頭 |
|
| DLL |
|