SHGetSpecialFolderPathA 함수(shlobj_core.h)
[SHGetSpecialFolderPath 는 지원되지 않습니다. 대신 SHGetFolderPath를 사용합니다.]
CSIDL로 식별되는 특수 폴더의 경로를 검색합니다.
구문
BOOL SHGetSpecialFolderPathA(
HWND hwnd,
[out] LPSTR pszPath,
[in] int csidl,
[in] BOOL fCreate
);
매개 변수
hwnd
형식: HWND
예약되어 있습니다.
[out] pszPath
형식: LPTSTR
지정된 폴더의 드라이브와 경로를 수신하는 null로 끝나는 문자열에 대한 포인터입니다. 이 버퍼의 크기는 최소 MAX_PATH 문자여야 합니다.
[in] csidl
형식: int
관심 있는 폴더를 식별하는 CSIDL 입니다. 가상 폴더를 지정하면 이 함수가 실패합니다.
[in] fCreate
형식: BOOL
폴더가 아직 없는 경우 폴더를 만들어야 하는지 여부를 나타냅니다. 이 값이 0이 아니면 폴더가 만들어집니다. 이 값이 0이면 폴더가 만들어지지 않습니다.
반환 값
형식: BOOL
성공하면 TRUE이고, 그렇지 않으면 FALSE입니다.
설명
이 기능을 사용하려면 Microsoft Internet Explorer 4.0 데스크톱 업데이트를 설치해야 합니다.
참고
shlobj_core.h 헤더는 UNICODE 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 SHGetSpecialFolderPath를 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
대상 플랫폼 | Windows |
헤더 | shlobj_core.h(Shlobj.h, Shlobj_core.h 포함) |
라이브러리 | Shell32.lib |
DLL | Shell32.dll(버전 4.71 이상) |