SHFOLDERCUSTOMSETTINGS-Struktur (shlobj_core.h)

Enthält benutzerdefinierte Ordnereinstellungen. Diese Struktur wird mit der SHGetSetFolderCustomSettings-Funktion verwendet.

Syntax

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;

Member

dwSize

Art: DWORD

Die Größe der Struktur in Bytes.

dwMask

Art: DWORD

Ein DWORD-Wert , der angibt, welche Ordnerattribute aus dieser Struktur gelesen oder geschrieben werden sollen. Verwenden Sie einen oder mehrere der folgenden Werte, um anzugeben, welche Strukturmber gültig sind:

FCSM_VIEWID

Deprecated. pvid enthält die GUID des Ordners.

FCSM_WEBVIEWTEMPLATE

Deprecated. pszWebViewTemplate enthält einen Zeiger auf einen Puffer, der den Pfad zur WebView-Vorlage des Ordners enthält.

FCSM_INFOTIP

pszInfoTip enthält einen Zeiger auf einen Puffer, der den Infotipp des Ordners enthält.

FCSM_CLSID

pclsid enthält die CLSID des Ordners.

FCSM_ICONFILE

pszIconFile enthält den Pfad zu der Datei, die das Ordnersymbol enthält.

FCSM_LOGO

pszLogo enthält den Pfad zu der Datei, die das Miniaturansichtssymbol des Ordners enthält.

FCSM_FLAGS

Wird nicht verwendet.

pvid

Typ: SHELLVIEWID*

Die GUID des Ordners.

pszWebViewTemplate

Typ: LPTSTR

Ein Zeiger auf eine NULL-endende Zeichenfolge, die den Pfad zur WebView-Vorlage des Ordners enthält.

cchWebViewTemplate

Art: DWORD

Wenn der SHGetSetFolderCustomSettings-ParameterdwReadWriteFCS_READ ist, ist dies die Größe des pszWebViewTemplate-Puffers in Zeichen. Wenn dies nicht der Fall ist, ist dies die Anzahl der Zeichen, die aus diesem Puffer geschrieben werden sollen. Legen Sie diesen Parameter auf 0 fest, um die gesamte Zeichenfolge zu schreiben.

pszWebViewTemplateVersion

Typ: LPTSTR

Ein Zeiger auf einen Puffer mit NULL-Beendigung, der die WebView-Vorlagenversion enthält.

pszInfoTip

Typ: LPTSTR

Ein Zeiger auf einen Puffer mit NULL-Beendigung, der den Text des Infotips des Ordners enthält.

cchInfoTip

Art: DWORD

Wenn der SHGetSetFolderCustomSettings-ParameterdwReadWriteFCS_READ ist, ist dies die Größe des pszInfoTip-Puffers in Zeichen. Wenn dies nicht der Fall ist, ist dies die Anzahl der Zeichen, die aus diesem Puffer geschrieben werden sollen. Legen Sie diesen Parameter auf 0 fest, um die gesamte Zeichenfolge zu schreiben.

pclsid

Typ: CLSID*

Ein Zeiger auf eine CLSID, die zum Identifizieren des Ordners in der Windows-Registrierung verwendet wird. Weitere Ordnerinformationen werden in der Registrierung unter diesem CLSID-Eintrag gespeichert.

dwFlags

Art: DWORD

Wird nicht verwendet.

pszIconFile

Typ: LPTSTR

Ein Zeiger auf einen Puffer mit NULL-Beendigung, der den Pfad zur Datei mit dem Ordnersymbol enthält.

cchIconFile

Art: DWORD

Wenn der SHGetSetFolderCustomSettings-ParameterdwReadWriteFCS_READ ist, ist dies die Größe des pszIconFile-Puffers in Zeichen. Wenn dies nicht der Fall ist, ist dies die Anzahl der Zeichen, die aus diesem Puffer geschrieben werden sollen. Legen Sie diesen Parameter auf 0 fest, um die gesamte Zeichenfolge zu schreiben.

iIconIndex

Typ: int

Der Index des Symbols in der Datei mit dem Namen in pszIconFile.

pszLogo

Typ: LPTSTR

Ein Zeiger auf einen Puffer mit NULL-Beendigung, der den Pfad zu der Datei enthält, die das Logobild des Ordners enthält. Dies ist das Bild, das in Miniaturansichten verwendet wird.

cchLogo

Art: DWORD

Wenn der SHGetSetFolderCustomSettings-ParameterdwReadWriteFCS_READ ist, ist dies die Größe des pszLogo-Puffers in Zeichen. Wenn dies nicht der Fall ist, ist dies die Anzahl der Zeichen, die aus diesem Puffer geschrieben werden sollen. Legen Sie diesen Parameter auf 0 fest, um die gesamte Zeichenfolge zu schreiben.

Hinweise

In Windows XP Service Pack 2 (SP2) und früheren Versionen unterstützte diese Struktur sowohl ANSI- als auch Unicode-Zeichenfolgen. In Windows Vista und höheren Versionen werden nur Unicode-Zeichenfolgen unterstützt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	shlobj_core.h (shlobj.h einschließen)