Oracle® Objects for OLE C++ Class Library Developer's Guide 10g Release 2 (10.2) B14308-01 |
|
Applies To
Description
Reads into a buffer a specified portion of OBlob, OClob, or OBfile value. Returns the total amount of data read in bytes.
Usage
unsigned long Read(unsigned char *buffer, unsigned long buffersize, unsigned long offset = 0) const throw(OException)
unsigned long Read(short *status, unsigned char *buffer, unsigned long buffersize, unsigned long offset = 0) const throw(OException)
Arguments
Arguments |
Description |
---|---|
status | Status of the current operation. Possible return values are:
|
buffer | Pointer to user-supplied buffer. |
buffersize | Size of the buffer. In bytes for OBlob, in bytes for OClob if streaming is enabled, otherwise in characters. |
offset | 1-based offset into the LOB where reading will begin. The default value of zero causes the read to start at the beginning of the LOB in non-streaming mode or the value passed to EnableStreaming when in streaming mode. In bytes for OBlob, characters for OClob. |
This method reads the LOB or BFILE data from the offset and returns the number of bytes read.
See the Remarks for EnableStreaming. See GetOptimumChunkSize for additional comments.
Examples