IOpcFactory::CreateStreamOnFile 메서드(msopc.h)

아티클
11/20/2024

파일을 통해 스트림을 만듭니다. 이 메서드는 CreateFile 함수를 호출하기 위한 간소화된 래퍼입니다. 이 메서드를 통해 노출되지 않은 CreateFile 매개 변수는 기본값을 사용합니다. 자세한 내용은 CreateFile참조하세요.

통사론

HRESULT CreateStreamOnFile(
  [in]          LPCWSTR               filename,
  [in]          OPC_STREAM_IO_MODE    ioMode,
  [in]          LPSECURITY_ATTRIBUTES securityAttributes,
  [in]          DWORD                 dwFlagsAndAttributes,
  [out, retval] IStream               **stream
);

매개 변수

[in] filename

스트림이 만들어지는 파일의 이름입니다.

[in] ioMode

만들 스트림의 읽기/쓰기 상태를 설명하는 값입니다.

[in] securityAttributes

이 매개 변수의 SECURITY_ATTRIBUTES 구조에 대한 자세한 내용은 CreateFile 함수를 참조하세요.

[in] dwFlagsAndAttributes

파일의 설정 및 특성입니다. 대부분의 파일에서 FILE_ATTRIBUTE_NORMAL 사용할 수 있습니다.

이 매개 변수에 대한 자세한 내용은 CreateFile참조하세요.

[out, retval] stream

스트림의 IStream 인터페이스에 대한 포인터입니다.

반환 값

이 메서드는 HRESULT반환합니다. 가능한 값은 다음 표에 있는 값을 포함하지만 제한되지는 않습니다.

반환 코드	묘사
S_OK	메서드가 성공했습니다.
E_INVALIDARG	ioMode 매개 변수에 전달된 값이 유효한 OPC_STREAM_IO_MODE 열거형 값이 아닙니다.
E_POINTER	파일 이름 및 스트림 매개 변수 중 하나 이상이 NULL.
CreateFile 함수 오류	CreateFile 함수의 HRESULT 오류 코드입니다.

발언

동일한 스트림을 사용하여 패키지를 역직렬화하는 경우 스트림을 사용하여 패키지 데이터를 직렬화하지 마세요. 이는 정의되지 않은 동작이 발생할 수 있기 때문입니다.

패키지를 로드하거나 저장할 때 이 메서드를 사용하는 방법에 대한 자세한 내용은 패키지 로드 또는 패키지 프로그래밍 작업 저장 참조하세요.

이전 Windows 버전에서 지원

이 메서드의 동작 및 성능은 지원되는 모든 Windows 버전에서 동일합니다. 자세한 내용은 패키징 API시작 및 Windows Vista대한 플랫폼 업데이트를 참조하세요.

스레드 안전성

패키징 개체는 스레드로부터 안전하지 않습니다.

자세한 내용은 패키징 API시작하는 참조하세요.

요구 사항

요구	값
지원되는 최소 클라이언트	Windows 7, Windows Vista SP2 및 Windows Vista용 플랫폼 업데이트가 있는 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 R2, Windows Server 2008 SP2 및 Windows Server 2008용 플랫폼 업데이트[데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	msopc.h