영어로 읽기

다음을 통해 공유


COleStreamFile 클래스

OLE 구조적 스토리지의 일부로 복합 파일의 데이터 스트림(IStream)을 나타냅니다.

구문

class COleStreamFile : public CFile

멤버

공용 생성자

속성 설명
COleStreamFile::COleStreamFile COleStreamFile 개체를 생성합니다.

공용 메서드

이름 설명
COleStreamFile::Attach 스트림을 개체와 연결합니다.
COleStreamFile::CreateMemoryStream 전역 메모리에서 스트림을 만들고 개체와 연결합니다.
COleStreamFile::CreateStream 스트림을 만들어 개체와 연결합니다.
COleStreamFile::D etach 개체에서 스트림을 연결 해제합니다.
COleStreamFile::GetStream 현재 스트림을 반환합니다.
COleStreamFile::OpenStream 스트림을 안전하게 열고 개체와 연결합니다.

설명

메모리 스트림이 IStorage 아닌 경우 스트림을 열거나 만들려면 먼저 개체가 있어야 합니다.

COleStreamFile개체는 CFile 개체와 똑같이 조작됩니다.

스트림 및 스토리지 조작에 대한 자세한 내용은 컨테이너: 복합 파일 문서를 참조하세요.

자세한 내용은 Windows SDK의 IStreamIStorage 를 참조하세요.

상속 계층 구조

CObject

CFile

COleStreamFile

요구 사항

헤더: afxole.h

COleStreamFile::Attach

제공된 OLE 스트림을 개체와 연결합니다 COleStreamFile .

void Attach(LPSTREAM lpStream);

매개 변수

lpStream
개체와 연결할 OLE 스트림(IStream)을 가리킵니다. NULL일 수 없습니다.

설명

개체를 OLE 스트림과 연결하지 않아야 합니다.

자세한 내용은 Windows SDK의 IStream을 참조하세요.

COleStreamFile::COleStreamFile

COleStreamFile 개체를 만듭니다.

COleStreamFile(LPSTREAM lpStream = NULL);

매개 변수

lpStream
개체와 연결할 OLE 스트림에 대한 포인터입니다.

설명

lpStream이 NULL이면 개체가 OLE 스트림과 연결되지 않고, 그렇지 않으면 개체가 제공된 OLE 스트림과 연결됩니다.

자세한 내용은 Windows SDK의 IStream을 참조하세요.

COleStreamFile::CreateMemoryStream

오류가 정상이고 예상되는 상태인 전역 공유 메모리에서 새 스트림을 안전하게 만듭니다.

BOOL CreateMemoryStream(CFileException* pError = NULL);

매개 변수

pError
만들기 작업의 완료 상태를 나타내는 CFileException 개체 또는 NULL을 가리킵니다. 스트림을 만들려고 시도하여 생성된 가능한 예외를 모니터링하려면 이 매개 변수를 제공합니다.

Return Value

스트림이 성공적으로 만들어지면 0이 아닌 경우 그렇지 않으면 0입니다.

설명

메모리는 OLE 하위 시스템에 의해 할당됩니다.

자세한 내용은 Windows SDK의 CreateStreamOnHGlobal 을 참조하세요.

COleStreamFile::CreateStream

제공된 스토리지 개체에 오류가 정상이고 예상되는 상태인 새 스트림을 안전하게 만듭니다.

BOOL CreateStream(
    LPSTORAGE lpStorage,
    LPCTSTR lpszStreamName,
    DWORD nOpenFlags = modeReadWrite|shareExclusive|modeCreate,
    CFileException* pError = NULL);

매개 변수

lpStorage
만들 스트림이 포함된 OLE 스토리지 개체를 가리킵니다. NULL일 수 없습니다.

lpszStreamName
만들 스트림의 이름입니다. NULL일 수 없습니다.

nOpenFlags
스트림을 열 때 사용할 액세스 모드입니다. 배타적, 읽기/쓰기 및 만들기 모드는 기본적으로 사용됩니다. 사용 가능한 모드의 전체 목록은 CFile::CFile을 참조 하세요.

pError
CFileException 개체 또는 NULL을 가리킵니다. 스트림을 만들려고 시도하여 생성된 가능한 예외를 모니터링하려면 이 매개 변수를 제공합니다.

Return Value

스트림이 성공적으로 만들어지면 0이 아닌 경우 그렇지 않으면 0입니다.

설명

열기가 실패하고 pError 가 NULL이 아닌 경우 파일 예외가 throw됩니다.

자세한 내용은 Windows SDK의 IStorage::CreateStream 을 참조하세요.

COleStreamFile::D etach

스트림을 닫지 않고 개체에서 스트림을 연결 해제합니다.

LPSTREAM Detach();

Return Value

개체와 연결된 스트림(IStream)에 대한 포인터입니다.

설명

프로그램이 종료되기 전에 스트림을 다른 방식으로 닫아야 합니다.

자세한 내용은 Windows SDK의 IStream을 참조하세요.

COleStreamFile::GetStream

현재 스트림에 대한 포인터를 반환하려면 이 함수를 호출합니다.

IStream* GetStream() const;

Return Value

현재 스트림 인터페이스( IStream)에 대한 포인터입니다.

COleStreamFile::OpenStream

기존 스트림을 엽니다.

BOOL OpenStream(
    LPSTORAGE lpStorage,
    LPCTSTR lpszStreamName,
    DWORD nOpenFlags = modeReadWrite|shareExclusive,
    CFileException* pError = NULL);

매개 변수

lpStorage
열 스트림이 포함된 OLE 스토리지 개체를 가리킵니다. NULL일 수 없습니다.

lpszStreamName
열 스트림의 이름입니다. NULL일 수 없습니다.

nOpenFlags
스트림을 열 때 사용할 액세스 모드입니다. 배타적 및 읽기/쓰기 모드는 기본적으로 사용됩니다. 사용 가능한 모드의 전체 목록은 CFile::CFile을 참조 하세요.

pError
CFileException 개체 또는 NULL을 가리킵니다. 스트림을 열어 생성된 가능한 예외를 모니터링하려면 이 매개 변수를 제공합니다.

Return Value

스트림이 성공적으로 열리면 0이 아닌 경우 그렇지 않으면 0입니다.

설명

열기가 실패하고 pError 가 NULL이 아닌 경우 파일 예외가 throw됩니다.

자세한 내용은 Windows SDK에서 IStorage::OpenStream 을 참조하세요.

참고 항목

CFile 클래스
계층 구조 차트