SHCreateStreamOnFileEx 함수(shlwapi.h)

파일을 열거나 만들고 해당 파일을 읽거나 쓸 스트림을 검색합니다.

구문

LWSTDAPI SHCreateStreamOnFileEx(
  [in]           LPCWSTR pszFile,
  [in]           DWORD   grfMode,
  [in]           DWORD   dwAttributes,
  [in]           BOOL    fCreate,
  [in, optional] IStream *pstmTemplate,
  [out]          IStream **ppstm
);

매개 변수

[in] pszFile

형식: LPCWSTR

파일 이름을 지정하는 null로 끝나는 문자열에 대한 포인터입니다.

[in] grfMode

형식:DWORD

파일 액세스 모드를 지정하는 데 사용되는 하나 이상의 STGM 값과 스트림을 노출하는 개체를 만들고 삭제하는 방법입니다.

[in] dwAttributes

형식:DWORD

새 파일이 만들어지는 경우 파일 특성을 지정하는 하나 이상의 플래그 값입니다. 가능한 값의 전체 목록은 CreateFile 함수의 dwFlagsAndAttributes 매개 변수를 참조하세요.

[in] fCreate

형식: BOOL

grfMode와 함께 스트림을 만들 때 기존 파일을 처리하는 방법을 지정하는 데 도움이 되는 BOOL 값입니다. 자세한 내용은 설명을 참조하세요.

[in, optional] pstmTemplate

형식: IStream*

예약되어 있습니다.

[out] ppstm

형식: IStream**

파일과 연결된 스트림에 대한 IStream 인터페이스 포인터를 받습니다.

반환 값

형식: HRESULT

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

설명

SHCreateStreamOnFileEx 함수는 STGM 플래그의 의미 체계를 확장하고 CreateFile 함수 호출과 동일한 효과를 생성합니다.

grfMode 및 fCreate 매개 변수는 함께 작동하여 함수가 기존 파일과 관련하여 작동하는 방식을 지정합니다.

grfMode	f만들기	파일이 있나요?	동작
STGM_CREATE	무시됨	Yes	파일이 다시 만들어집니다.
STGM_CREATE	무시됨	No	파일이 생성됩니다.
STGM_FAILIFTHERE	FALSE	Yes	파일이 열립니다.
STGM_FAILIFTHERE	FALSE	No	호출이 실패합니다.
STGM_FAILIFTHERE	TRUE	Yes	호출이 실패합니다.
STGM_FAILIFTHERE	TRUE	No	파일이 생성됩니다.

요구 사항

지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	shlwapi.h
라이브러리	Shlwapi.lib
DLL	Shlwapi.dll(버전 6.0 이상)