設定回呼函式

Configure函式會設定專家 DLL 內的專家。

專家必須實作 Configure 函式。 收到函式呼叫時，專家會顯示一個對話方塊，讓使用者能夠變更任何可設定的專案。

語法

BOOL WINAPI Configure(
  _In_    HEXPERTKEY         hExpertKey,
  _Inout_ PEXPERTCONFIG      *ppConfig,
  _In_    PEXPERTSTARTUPINFO pExpertStartupInfo,
  _In_    DWORD              StartupFlags,
  _In_    HWND               hWnd
);

參數

hExpertKey [in]

唯一專家識別碼。

唯一識別碼會傳回所有專家特定的網路監視器功能。 請注意，識別碼可能與傳遞至 Run 函式的識別碼不相同。 請勿從 [ 設定 ] 呼叫儲存專家金鑰。

ppConfig [in， out]

專案時 ，EXPERTCONFIG 結構的指標。

成功結束之後，參考的 EXPERTCONFIG 結構會包含新的組態資料。

pExpertStartupInfo [in]

專家啟動時具有焦點的擷取元素指標。

StartupFlags [in]

指出專家如何使用 pExpertStartupInfo 參數的旗標。 唯一定義的旗標 是EXPERT_STARTUP_FLAG_USE_STARTUP_DATA_OVER_CONFIG_DATA。 旗標表示專家將使用 pExpertStartupInfo 參數，而不是傳入的 ppConfig 參數。 一般而言，當您從操作功能表啟動專家時，您會設定旗標。

hWnd [in]

父視窗的控制碼。 使用控制碼開啟對話方塊。

傳回值

如果函式成功 (也就是說，如果目前組態存在) ，則傳回值為 TRUE。

如果函式不成功，則傳回值為 FALSE。

備註

如果存在，網路監視器會使用專家目前的設定呼叫 Configure 函式。 專家會顯示一個對話方塊，您可以使用此對話方塊來變更任何可設定的專案。

傳入 ppConfig 且網路監視器沒有為指定專家儲存的組態時，參數值可以是 Null。 在此情況下， Configure 函式會假設 (硬式編碼的預設值，或使用啟動資訊) 開啟對話方塊。

當Configure函式傳回時，設定資料也可以是Null，而且已傳入Null。 當網路監視器沒有儲存的預設值，且使用者按下 [取消] 時，就會發生這種情況。

EXPERTCONFIG資料結構的開頭包含儲存結構大小資訊的 Private 區段。 EXPERTCONFIG結構的大小應該包含結構開頭出現的保留DWORD長度。 例如，如果您的設定資料需要 20 個位元組的儲存空間，請配置 24 個位元組來儲存資料。 如果 ppConfig 為 Null， Configure 函式會呼叫 ExpertAllocMemory 函式 來配置大小正確的新設定。 如果緩衝區不足以保存專家資料，專家應該呼叫 ExpertReallocMemory 函式 。

規格需求

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