GetNPPBlobFromUI 函式

GetNPPBlobFromUI函式會選取暫存器 NIC。

語法

DWORD GetNPPBlobFromUI(
  _In_  HWND  hwnd,
  _In_  HBLOB hFilterBlob,
  _Out_ HBLOB *phBlob
);

參數

hwnd [in]

視窗的控制碼，顯示 [ 選取網路 ] 對話方塊。

hFilterBlob [in]

篩選 BLOB的控制碼，用來限制顯示哪些 NIC。

phBlob [out]

代表所選取 NIC 之 BLOB 控制碼的指標。

傳回值

如果函式成功 (使用者選取 NIC) ，則會NMERR_SUCCESS傳回值，而 phBlob 所指向的 BLOB 會填入。

如果使用者未選取 NIC，則會 NMERR_NO_NPP_SELECTED傳回值。

如果函式失敗，傳回值會是另一個 NMERR 值。

備註

呼叫時，網路監視器會顯示 [ 選取網路 ] 對話方塊，您可以使用此對話方塊來選取 NIC。 代表 NIC 的 NPP BLOB 會傳回給呼叫的應用程式。

如果 hFilterBlob 所命名的 BLOB 是特殊的 BLOB，則尋找者會嘗試處理它。 例如，先前從遠端 NPP 傳回特殊 BLOB 的呼叫。 應用程式已插入必要的標籤，MACHINE_NAME。 在此情況下，尋找器會將此 BLOB 傳遞至遠端 NPP，然後傳回代表所要求機器的 NPP BLOB 資料表。 這些遠端 NPP BLOB 會出現在對話方塊中。

呼叫端必須呼叫 DestroyBlob 函式，此函式不再需要時會終結傳回的 BLOB。

如需下列項目的詳細資訊	請參閱
三種方式可選取 NIC	選取網路介面卡
指定篩選 BLOB	指定篩選 BLOB

規格需求

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

另請參閱

GetNPPBlobTable

SelectNPPBlobFromTable