IItemNameLimits::GetValidCharacters メソッド (shobjidl_core.h)

呼び出される名前空間で有効または無効な各文字を含む文字列を読み込みます。

構文

HRESULT GetValidCharacters(
  [out] LPWSTR *ppwszValidChars,
  [out] LPWSTR *ppwszInvalidChars
);

パラメーター

[out] ppwszValidChars

種類: LPWSTR*

名前空間内のすべての有効な文字を含む文字列へのポインター。 名前空間が ppwszInvalidCharsに無効な文字を提供する場合、この値は NULL を返します。 詳細については、「解説」を参照してください。

[out] ppwszInvalidChars

種類: LPWSTR*

名前空間内のすべての無効な文字を含む文字列へのポインター。

戻り値

種類: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

解説

たとえば、標準ファイル システムは文字列 "/:*?"<>|" を返します。ppwszInvalidChars では、ppwszValidChars では NULL。

どちらのパラメーターも NULL 以外の値を返すことができないため、ppwszValidChars には NULL 以外の値が割り当てられます

ppwszInvalidChars 内。 指定された無効な文字がある場合、それ以外はすべて有効であると見なされます。 ppwszInvalidChars が NULL の場合にのみ、ppwszValidChars にはすべての有効な文字の一覧が含まれます。

メソッドが成功コードを返す場合は、 CoTaskMemFree を使用して割り当てられた文字列を解放する必要があります。

要件