SHFOLDERCUSTOMSETTINGS 構造体 (shlobj_core.h)

  • [アーティクル]

カスタム フォルダー設定を保持します。 この構造体は、 SHGetSetFolderCustomSettings 関数と共に使用されます。

構文

typedef struct {
  DWORD       dwSize;
  DWORD       dwMask;
  SHELLVIEWID *pvid;
  LPWSTR      pszWebViewTemplate;
  DWORD       cchWebViewTemplate;
  LPWSTR      pszWebViewTemplateVersion;
  LPWSTR      pszInfoTip;
  DWORD       cchInfoTip;
  CLSID       *pclsid;
  DWORD       dwFlags;
  LPWSTR      pszIconFile;
  DWORD       cchIconFile;
  int         iIconIndex;
  LPWSTR      pszLogo;
  DWORD       cchLogo;
} SHFOLDERCUSTOMSETTINGS, *LPSHFOLDERCUSTOMSETTINGS;

メンバー

dwSize

型: DWORD

この構造体のサイズ (バイト単位)。

dwMask

型: DWORD

この構造体から読み取りまたは書き込むフォルダー属性を指定する DWORD 値。 次の値のうち 1 つ以上を使用して、有効な構造体メンバーを示します。

FCSM_VIEWID

推奨されなくなった値です。 pvid には、フォルダーの GUID が含まれています。

FCSM_WEBVIEWTEMPLATE

推奨されなくなった値です。 pszWebViewTemplate には、フォルダーの WebView テンプレートへのパスを含むバッファーへのポインターが含まれています。

FCSM_INFOTIP

pszInfoTip には、フォルダーの情報ヒントを含むバッファーへのポインターが含まれています。

FCSM_CLSID

pclsid には、フォルダーの CLSID が含まれています。

FCSM_ICONFILE

pszIconFile には、フォルダーのアイコンを含むファイルへのパスが含まれています。

pszLogo には、フォルダーのサムネイル アイコンを含むファイルへのパスが含まれています。

FCSM_FLAGS

使用されていません。

pvid

型: SHELLVIEWID*

フォルダーの GUID。

pszWebViewTemplate

種類: LPTSTR

フォルダーの WebView テンプレートへのパスを含む null で終わる文字列へのポインター。

cchWebViewTemplate

型: DWORD

SHGetSetFolderCustomSettings パラメーター dwReadWrite がFCS_READ場合、これは pszWebViewTemplate バッファーのサイズ (文字単位) です。 そうでない場合は、そのバッファーから書き込む文字数です。 文字列全体を書き込むには、このパラメーターを 0 に設定します。

pszWebViewTemplateVersion

種類: LPTSTR

WebView テンプレート バージョンを含む null で終わるバッファーへのポインター。

pszInfoTip

種類: LPTSTR

フォルダーのヒントのテキストを含む null で終わるバッファーへのポインター。

cchInfoTip

型: DWORD

SHGetSetFolderCustomSettings パラメーター dwReadWrite がFCS_READ場合、これは pszInfoTip バッファーのサイズ (文字単位) です。 そうでない場合は、そのバッファーから書き込む文字数です。 文字列全体を書き込むには、このパラメーターを 0 に設定します。

pclsid

型: CLSID*

Windows レジストリ内のフォルダーを識別するために使用される CLSID へのポインター。 その他のフォルダー情報は、その CLSID エントリの下のレジストリに格納されます。

dwFlags

型: DWORD

使用されていません。

pszIconFile

種類: LPTSTR

フォルダーのアイコンを含むファイルへのパスを含む null で終わるバッファーへのポインター。

cchIconFile

型: DWORD

SHGetSetFolderCustomSettings パラメーター dwReadWrite がFCS_READ場合、これは pszIconFile バッファーのサイズ (文字単位) です。 そうでない場合は、そのバッファーから書き込む文字数です。 文字列全体を書き込むには、このパラメーターを 0 に設定します。

iIconIndex

型: int

pszIconFile で指定されたファイル内のアイコンのインデックス。

pszLogo

種類: LPTSTR

フォルダーのロゴ イメージを含むファイルへのパスを含む null で終わるバッファーへのポインター。 これはサムネイル ビューで使用される画像です。

cchLogo

型: DWORD

SHGetSetFolderCustomSettings パラメーター dwReadWrite がFCS_READ場合、これは pszLogo バッファーのサイズ (文字単位) です。 そうでない場合は、そのバッファーから書き込む文字数です。 文字列全体を書き込むには、このパラメーターを 0 に設定します。

注釈

Windows XP Service Pack 2 (SP2) 以前のバージョンでは、この構造体は ANSI 文字列と Unicode 文字列の両方をサポートしていました。 Windows Vista 以降のバージョンでは、Unicode 文字列のみがサポートされています。

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
Header shlobj_core.h (Shlobj.h を含む)