COleStreamFile::CreateStream

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

Return Value

Nonzero if the stream is created successfully; otherwise 0.

Parameters

lpStorage

Points to the OLE storage object that contains the stream to be created. Cannot be NULL.

lpszStreamName

Name of the stream to be created. Cannot be NULL.

nOpenFlags

Access mode to use when opening the stream. Exclusive, read/write, and create modes are used by default. For a complete list of the available modes, see CFile::CFile.

pError

Points to a CFileException object or NULL. Supply this parameter if you want to monitor possible exceptions generated by attempting to create the stream.

Remarks

Safely creates a new stream in the supplied storage object where a failure is a normal, expected condition. A file exception will be thrown if the open fails and pError is not NULL.

For more information, see IStorage::CreateStream in the OLE 2 Programmer’s Reference, Volume 1.

COleStreamFile OverviewClass MembersHierarchy Chart

See Also   COleStreamFile::OpenStream, COleStreamFile::CreateMemoryStream, CFileException