SVR5 and SCO OpenServer 5

GetFirstTuple(D3pccard)

GetFirstTuple -- return first tuple of specified type

Synopsis

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

Description

GetFirstTuple( ) reads the card's CIS and returns the first tuple of the specified type.

Arguments

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

Return values

NO_MORE_ITEMS: There are no tuples to be had.
SUCCESS: First tuple found.

Usage

GetFirstTuple( ) is called as part of client initialization, configuration, and validation.

Context and synchronization

Interrupt, user, or initialization context

Hardware applicability

All

Version applicability

pccard: 1, 2, 3

References

GetNextTuple(D3pccard), GetTupleData(D3pccard), Tuple(D4pccard)

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