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 값입니다. 다음 값 중 하나 이상을 사용하여 유효한 구조체 멤버를 나타냅니다.

FCSM_VIEWID

사용되지 않음. pvid 에는 폴더의 GUID가 포함되어 있습니다.

FCSM_WEBVIEWTEMPLATE

사용되지 않음. pszWebViewTemplate 에는 폴더의 WebView 템플릿에 대한 경로가 포함된 버퍼에 대한 포인터가 포함되어 있습니다.

FCSM_INFOTIP

pszInfoTip 에는 폴더의 정보 팁이 포함된 버퍼에 대한 포인터가 포함되어 있습니다.

FCSM_CLSID

pclsid 에는 폴더의 CLSID가 포함되어 있습니다.

FCSM_ICONFILE

pszIconFile 에는 폴더 아이콘이 포함된 파일의 경로가 포함되어 있습니다.

FCSM_LOGO

pszLogo 에는 폴더의 축소판 그림 아이콘이 포함된 파일의 경로가 포함되어 있습니다.

FCSM_FLAGS

사용되지 않습니다.

pvid

형식: SHELLVIEWID*

폴더의 GUID입니다.

pszWebViewTemplate

형식: LPTSTR

폴더의 WebView 템플릿 경로를 포함하는 null로 끝나는 문자열에 대한 포인터입니다.

cchWebViewTemplate

형식:DWORD

SHGetSetFolderCustomSettings 매개 변수 dwReadWrite가 FCS_READ 경우 pszWebViewTemplate 버퍼의 크기(문자)입니다. 그렇지 않은 경우 해당 버퍼에서 쓸 문자 수입니다. 이 매개 변수를 0으로 설정하여 전체 문자열을 작성합니다.

pszWebViewTemplateVersion

형식: LPTSTR

WebView 템플릿 버전을 포함하는 null 종료 버퍼에 대한 포인터입니다.

pszInfoTip

형식: LPTSTR

폴더의 infotip 텍스트를 포함하는 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 SP2(서비스 팩 2) 및 이전 버전에서 이 구조는 ANSI 및 유니코드 문자열을 모두 지원했습니다. Windows Vista 이상 버전에서는 유니코드 문자열만 지원됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
머리글	shlobj_core.h(Shlobj.h 포함)