IOfflineFilesItemFilter::GetPatternFilter メソッド (cscobj.h)

項目名パターンに基づいて列挙項目を制限するフィルターパターン文字列を提供します。パターンフィルター処理は、包含フィルターに対してのみ使用できます。除外フィルターとしてパターンフィルターを指定した場合は無視されます。

構文

HRESULT GetPatternFilter(
  [out] LPWSTR pszPattern,
  [in]  ULONG  cchPattern
);

[out] pszPattern

フィルターパターン文字列を受け取ります。パターン文字列には、 * と ? を含めることができます。ワイルドカード文字。

例 :

[in] cchPattern

パターン文字列を受け取るバッファーの最大文字数を指定します。この値は現在 MAX_PATH。

フィルターがパターンフィルター処理をサポートし、フィルター文字列が pszPattern バッファーに正常にコピーされた場合は、 S_OK を返します。

パターンフィルター処理がサポートされていない場合は 、E_NOTIMPL を返します。

その他のエラー値を指定すると、列挙子の作成が失敗します。

このメソッドは、任意のフィルターの種類 (包含、除外) またはフィルターターゲット (ファイル、コンテナー) に実装できますが、包含フィルターとファイルターゲットに対してのみ呼び出されます。このメソッドは、他のフィルターの種類とターゲットの組み合わせに対して呼び出されることはありません。

このページはお役に立ちましたか?