FilterCreate 函式 (fltuser.h)

FilterCreate函式會為指定的迷你篩選器建立控制碼。

語法

HRESULT FilterCreate(
  [in]  LPCWSTR lpFilterName,
  [out] HFILTER *hFilter
);

[in] lpFilterName

包含迷你篩選名稱的 Null 終止寬字元字串指標。這個參數是必要的，而且不能是 Null。

[out] hFilter

呼叫者配置的變數指標，如果 對 FilterCreate 的呼叫成功，則接收迷你篩選程式的控制碼;否則，它會收到INVALID_HANDLE_VALUE。

如果成功，FilterCreate會傳回S_OK。否則，它會傳回錯誤值。

使用者模式應用程式會呼叫 FilterCreate ，以建立可用來與核心模式迷你篩選程式通訊的控制碼。傳回的迷你篩選控制碼可以當作參數傳遞至 FilterGetInformation等函式。

若要關閉 FilterCreate傳回的篩選控制碼，請呼叫 FilterClose。