IDatabase::OpenStream method

  • Article

[OpenStream is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions.]

Opens a stream for access.

Syntax

HRESULT OpenStream(
  [in]  ACCESSTYPE  tyAccess,
  [in]  FILEADDRESS faStream,
  [out] IStream     **ppStream
);

Parameters

tyAccess [in]

Type: ACCESSTYPE

Specifies the access level being requested.

faStream [in]

Type: FILEADDRESS

Specifies the stream to open.

ppStream [out]

Type: IStream**

On success, contains the stream identifier for the new stream in the database specified by faStream.

Return value

Type: HRESULT

Use the SUCCEEDED macro to determine whether the operation succeeded.

Return code Description
DB_E_LOCKEDFORREAD
 Write access is requested and the stream is currently opened.
DB_E_LOCKEDFORWRITE
 Write access is requested and the stream is already open for write.
DB_E_STREAMTABLEFULL
 There are too many streams open.

Requirements
Minimum supported client
 Windows XP [desktop apps only]
Minimum supported server
 Windows Server 2003 [desktop apps only]
Product
 Outlook Express 6.0
IDL
Directdb.idl
DLL
Directdb.dll (version 6.0 or later)