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의 IStream 및 IStorage 를 참조하세요.
상속 계층 구조
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 을 참조하세요.