ISCardFileAccess::Read

The Read method reads and returns the specified data from a given file.

HRESULT Read(
  HSCARD_FILE hFile,
  LONG *lBytesToRead,
  SCARD_FLAGS flags,
  LPBYTEBUFFER *ppBuffer
);

Parameters

hFile [in]
Handle of the open file to access.
lBytesToRead [in]
Length of data to be read (in) or number of bytes read (out). Returns list of files as an array of BSTRs.
flags [in]
Specifies whether secure messaging should be used.
Flags…
SC_FL_SECURE_MESSAGING

ppBuffer [out, retval]
IByteBuffer containing the read data.

Return Values

The possible return values are the following:

Value Meaning
S_OK Operation completed successfully.
E_INVALIDARG Invalid parameter.
E_POINTER A bad pointer was passed in.
E_OUTOFMEMORY Out of memory.

Remarks

For a list of all the methods defined by the ISCardFileAccess interface, see ISCardFileAccess.

In addition to the COM error codes listed above, this interface may return a smart card error code if a smart card function was called to complete the request. For information on smart card error codes, see Smart Card Error Codes.

QuickInfo

  Windows NT: Use version 4.0 SP3 and later.
  Windows: Use Windows 95 OSR2.1.
  Windows CE: Unsupported.
  Header: Declared in scardcom.h.
  Import Library: scardcom.tlb (vendor-supplied).

See Also

ISCardFileAccess