SHGetSetFolderCustomSettings 함수(shlobj_core.h)

아티클
03/05/2024

[SHGetSetFolderCustomSettings 는 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다.]

사용자 지정 폴더 설정을 설정하거나 검색합니다. 이 함수는 에서 읽고 Desktop.ini 씁니다.

구문

SHSTDAPI SHGetSetFolderCustomSettings(
  [in, out] LPSHFOLDERCUSTOMSETTINGS pfcs,
  [in]      PCWSTR                   pszPath,
            DWORD                    dwReadWrite
);

매개 변수

[in, out] pfcs

형식: LPSHFOLDERCUSTOMSETTINGS

사용자 지정 폴더 설정을 제공하거나 받는 SHFOLDERCUSTOMSETTINGS 구조체에 대한 포인터입니다.

[in] pszPath

형식: PCTSTR

폴더의 경로를 포함하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다. 종료 null 문자를 포함하여 pszPath 의 길이는 MAX_PATH 이하여야 합니다.

dwReadWrite

형식:DWORD

함수의 동작을 제어하는 플래그입니다. 다음 값 중 하나일 수 있습니다.

FCS_READ(0x00000001)

pfcs에서 사용자 지정 폴더 설정을 검색합니다.

FCS_FORCEWRITE(0x00000002)

pfcs를 사용하여 값이 이미 있는지 여부에 관계없이 사용자 지정 폴더의 설정을 지정합니다.

FCS_WRITE(FCS_READ | FCS_FORCEWRITE)

값이 아직 없는 경우 pfcs 를 사용하여 사용자 지정 폴더의 설정을 지정합니다.

반환 값

형식: HRESULT

이 함수가 성공하면 S_OK 반환합니다. 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

유니코드 문자열만 지원됩니다.

Windows Server 2003 및 Windows XP: SHGetSetFolderCustomSettings 는 ANSI 및 유니코드 문자열을 모두 지원합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	shlobj_core.h(Shlobj.h 포함)
라이브러리	Shell32.lib
DLL	Shell32.dll(버전 6.0 이상)

다음을 통해 공유