Klasa COleStreamFile
Reprezentuje strumień danych (IStream) w pliku złożonym w ramach magazynu strukturalnego OLE.
Składnia
class COleStreamFile : public CFile
Elementy członkowskie
Konstruktory publiczne
| Nazwa/nazwisko | opis |
|---|---|
| COleStreamFile::COleStreamFile | COleStreamFile Tworzy obiekt. |
Metody publiczne
| Nazwa/nazwisko | opis |
|---|---|
| COleStreamFile::Attach | Kojarzy strumień z obiektem. |
| COleStreamFile::CreateMemoryStream | Tworzy strumień z pamięci globalnej i kojarzy go z obiektem. |
| COleStreamFile::CreateStream | Tworzy strumień i kojarzy go z obiektem. |
| COleStreamFile::D etach | Usuwa skojarzenie strumienia z obiektu. |
| COleStreamFile::GetStream | Zwraca bieżący strumień. |
| COleStreamFile::OpenStream | Bezpiecznie otwiera strumień i kojarzy go z obiektem. |
Uwagi
Obiekt IStorage musi istnieć przed otwarciem lub utworzeniem strumienia, chyba że jest to strumień pamięci.
COleStreamFile obiekty są manipulowane dokładnie tak jak obiekty CFile .
Aby uzyskać więcej informacji na temat manipulowania strumieniami i magazynami, zobacz artykuł Kontenery: pliki złożone.
Aby uzyskać więcej informacji, zobacz IStream i IStorage w zestawie Windows SDK.
Hierarchia dziedziczenia
COleStreamFile
Wymagania
Nagłówek: afxole.h
COleStreamFile::Attach
Kojarzy dostarczony strumień OLE z obiektem COleStreamFile .
void Attach(LPSTREAM lpStream);
Parametry
lpStream
Wskazuje strumień OLE (IStream), który ma być skojarzony z obiektem. Nie można mieć wartości NULL.
Uwagi
Obiekt nie może być jeszcze skojarzony ze strumieniem OLE.
Aby uzyskać więcej informacji, zobacz IStream w zestawie Windows SDK.
COleStreamFile::COleStreamFile
Tworzy obiekt COleStreamFile.
COleStreamFile(LPSTREAM lpStream = NULL);
Parametry
lpStream
Wskaźnik do strumienia OLE, który ma być skojarzony z obiektem.
Uwagi
Jeśli element lpStream ma wartość NULL, obiekt nie jest skojarzony ze strumieniem OLE, w przeciwnym razie obiekt jest skojarzony z podanym strumieniem OLE.
Aby uzyskać więcej informacji, zobacz IStream w zestawie Windows SDK.
COleStreamFile::CreateMemoryStream
Bezpiecznie tworzy nowy strumień z globalnej pamięci udostępnionej, w której awaria jest normalnym, oczekiwanym warunkiem.
BOOL CreateMemoryStream(CFileException* pError = NULL);
Parametry
pError
Wskazuje obiekt CFileException lub wartość NULL wskazującą stan ukończenia operacji tworzenia. Podaj ten parametr, jeśli chcesz monitorować możliwe wyjątki wygenerowane przez próbę utworzenia strumienia.
Wartość zwracana
Nonzero, jeśli strumień został utworzony pomyślnie; w przeciwnym razie 0.
Uwagi
Pamięć jest przydzielana przez podsystem OLE.
Aby uzyskać więcej informacji, zobacz CreateStreamOnHGlobal w zestawie Windows SDK.
COleStreamFile::CreateStream
Bezpiecznie tworzy nowy strumień w podanym obiekcie magazynu, w którym awaria jest normalnym, oczekiwanym warunkiem.
BOOL CreateStream(
LPSTORAGE lpStorage,
LPCTSTR lpszStreamName,
DWORD nOpenFlags = modeReadWrite|shareExclusive|modeCreate,
CFileException* pError = NULL);
Parametry
lpStorage
Wskazuje obiekt magazynu OLE zawierający strumień do utworzenia. Nie można mieć wartości NULL.
lpszStreamName
Nazwa strumienia do utworzenia. Nie można mieć wartości NULL.
nOpenFlags
Tryb dostępu do użycia podczas otwierania strumienia. Tryby wykluczania, odczytu/zapisu i tworzenia są domyślnie używane. Aby uzyskać pełną listę dostępnych trybów, zobacz CFile::CFile.
pError
Wskazuje obiekt CFileException lub wartość NULL. Podaj ten parametr, jeśli chcesz monitorować możliwe wyjątki wygenerowane przez próbę utworzenia strumienia.
Wartość zwracana
Nonzero, jeśli strumień został utworzony pomyślnie; w przeciwnym razie 0.
Uwagi
Wyjątek pliku zostanie zgłoszony, jeśli otwarcie zakończy się niepowodzeniem, a błąd pError nie ma wartości NULL.
Aby uzyskać więcej informacji, zobacz IStorage::CreateStream w zestawie Windows SDK.
COleStreamFile::D etach
Usuwa skojarzenie strumienia z obiektu bez zamykania strumienia.
LPSTREAM Detach();
Wartość zwracana
Wskaźnik do strumienia (IStream), który został skojarzony z obiektem.
Uwagi
Strumień musi zostać zamknięty w inny sposób, zanim program zakończy działanie.
Aby uzyskać więcej informacji, zobacz IStream w zestawie Windows SDK.
COleStreamFile::GetStream
Wywołaj tę funkcję, aby zwrócić wskaźnik do bieżącego strumienia.
IStream* GetStream() const;
Wartość zwracana
Wskaźnik do bieżącego interfejsu strumienia ( IStream).
COleStreamFile::OpenStream
Otwiera istniejący strumień.
BOOL OpenStream(
LPSTORAGE lpStorage,
LPCTSTR lpszStreamName,
DWORD nOpenFlags = modeReadWrite|shareExclusive,
CFileException* pError = NULL);
Parametry
lpStorage
Wskazuje obiekt magazynu OLE zawierający strumień do otwarcia. Nie można mieć wartości NULL.
lpszStreamName
Nazwa strumienia, który ma zostać otwarty. Nie można mieć wartości NULL.
nOpenFlags
Tryb dostępu do użycia podczas otwierania strumienia. Tryby wykluczania i zapisu są domyślnie używane. Aby uzyskać pełną listę dostępnych trybów, zobacz CFile::CFile.
pError
Wskazuje obiekt CFileException lub wartość NULL. Podaj ten parametr, jeśli chcesz monitorować możliwe wyjątki wygenerowane przez próbę otwarcia strumienia.
Wartość zwracana
Nonzero, jeśli strumień jest otwarty pomyślnie; w przeciwnym razie 0.
Uwagi
Wyjątek pliku zostanie zgłoszony, jeśli otwarcie zakończy się niepowodzeniem, a błąd pError nie ma wartości NULL.
Aby uzyskać więcej informacji, zobacz IStorage::OpenStream w zestawie Windows SDK.