共用方式為

IRTC：：Connect 方法

  • 發行項

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

語法

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

參數

hInputBlob [in]

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

StatusCallbackProc [in]

使用者的狀態回呼函式位址，該函式會接收狀態更新，例如觸發程式。 此參數可以設定為 Null。

FramesCallbackProc [in]

使用者框架回呼函式的位址，用來接收狀態更新，例如觸發程式。 此參數可以設定為 Null。

UserCoNtext [in]

呼叫使用者狀態和框架回呼函式時傳遞的值。 如果同時指定這兩個回呼函式，則必須使用相同的使用者內容值。 此參數的值通常是 HWND 或 'this' 指標。

hErrorBlob [out]

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

傳回值

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

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

傳回碼 Description
NMERR_ALREADY_CONNECTED
 NPP COM 物件的這個實例已經連線到網路。
NMERR_BLOB_CONVERSION_ERROR
 組態 BLOB 已損毀。 IRTC：：Configure呼叫會產生此錯誤。
NMERR_BLOB_ENTRY_DOES_NOT_EXIST
 hInputBlob參數指定的輸入 BLOB 缺少執行此作業所需的專案。 IRTC：：Connect或IRTC：：Configure呼叫可能會產生此錯誤。 查看 hErrorBlob 傳回的錯誤 BLOB，以判斷找不到哪個專案。
NMERR_BLOB_NOT_INITIALIZED
 尚未呼叫 CreateBlob 函式。 IRTC：：Configure呼叫會產生此錯誤。
NMERR_BLOB_STRING_INVALID
 字串不是以 Null 結尾。 IRTC：：Configure呼叫會產生此錯誤。
NMERR_ILLEGAL_TRIGGER
 輸入 BLOB 的觸發程式部分已損毀。 IRTC：：Configure呼叫會產生此錯誤。
NMERR_INVALID_BLOB
 hInputBlob中指定的物件不是 BLOB。 IRTC：：Configure呼叫會產生此錯誤。
NMERR_OUT_OF_MEMORY
 執行此作業所需的記憶體無法使用。 IRTC：：Configure呼叫會產生此錯誤。
NMERR_TIMEOUT
 要求已逾時。 IRTC：：Configure 呼叫會產生此錯誤。
NMERR_UPLEVEL_BLOB
 hInputBlob中指定的 BLOB 版本號碼不正確。 IRTC：：Configure呼叫會產生此錯誤。

備註

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

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

呼叫此函式時，即使您只做為預留位置，您也必須指定狀態或框架回呼函式。

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

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

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

規格需求

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

另請參閱

IRTC

IRTC：：Configure

IRTC：:D isconnect

IRTC：：Start