SVR5 and SCO OpenServer 5

GetNextTuple(D3pccard)

GetNextTuple -- return next tuple

Synopsis

   #include <sys/types.h>
   #include <sys/lcs.h>
   #include <sys/lss.h>
   
   int CardServices (GetNextTuple, int n1,
                     int n2, int TupleLen,
                     Tuple_t *pTuple, rm_key_t key);

Description

GetNextTuple( ) reads the CIS on the Client's card and returns the next tuple.

Arguments

n1: NULL
n2: NULL
TupleLen: Length of the Tuple(D4pccard) structure.
pTuple: Pointer to a Tuple(D4pccard) structure.
key: Resource manager key.

Return values

NO_MORE_ITEMS: There are no more tuples.
OUT_OF_RESOURCE: Attribute memory could not be set up to support the operation.
SUCCESS: Next tuple read successfully.

Usage

GetNextTuple( ) is called as part of client configuration and validation.

Context and synchronization

Interrupt, initialization, or user context

Hardware applicability

All

Version applicability

pccard: 1, 2, 3

References

GetFirstTuple(D3pccard), GetTupleData(D3pccard), Tuple(D4pccard)

config(D2pccard), init(D2pccard), _verify(D2pccard)