IDelaydC：：Connect 方法

  • 發行項

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

語法

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

參數

hInputBlob [in]

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

StatusCallbackProc [in]

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

UserCoNtext [in]

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

hErrorBlob [out]

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

傳回值

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

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

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

備註

呼叫Connect方法時，NPP 會使用hInputBlob提供的 BLOB 自動呼叫IDelaydC：：Configure。 請注意， 呼叫 IDelaydC：：Configure 傳回的任何錯誤碼，會由 IDelaydC：：Connect 呼叫傳回。

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

您可以呼叫GetNPPBlobFromUI、GetNPPBlobTable和SelectNPPBlobFromTable來取得hInputBlob參數指定的輸入 BLOB。

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

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

規格需求

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

另請參閱

IDelaydC

IDelaydC：：Configure

IDelaydC：:D isconnect

IDelaydC：：Start