SVR5 and SCO OpenServer 5

ReturnSSEntry(D3pccard)

ReturnSSEntry -- get pointer to an installed Socket Services routine

Synopsis

   #include <sys/types.h>
   #include <sys/lcs.h>
   #include <sys/lss.h>
   
   int CardServices (ReturnSSEntry, int n1,
                     SSEntry_t pfSSEntry, int ReturnSSEntryLen,
                     ReturnSSEntry_t *pReturnSSEntry, rm_key_t key);

Description

ReturnSSEntry( ) sends CardServices a pointer to the entry point of an installed Socket Services routine.

Arguments

n1

NULL

pfSSEntry

Pointer to an SSEntry(D4pccard) structure.

ReturnSSEntryLen

Length of the ReturnSSENtry structure. Must be set to 2.

pReturnSSEntry

Pointer to the entry point of an installed socket services routine. More than one such routine may be installed.

   typedef struct  ReturnSSEntry_t
   {
        	unsigned short   usAttributes;	/* SS entry point info */
   
   } ReturnSSEntry_t;

key

Resource manager key.

Return values

BAD_ARG_LENGTH: ReturnSSEntryLen not equal to 2.
SUCCESS: Socket services entry point successfuly accessed.

Usage

Clients should avoid making changes to the physical hardware state. Access socket services with caution, and only to query state information, never to modify it.

NOTE: The current implementation of CardServices supports only one controller and thus only one Socket Services routine (for logical socket 0).

Context and synchronization

Blockable, initialization, or user context

Hardware applicability

All

Version applicability

pccard: 1, 2, 3

References

SSEntry(D4pccard)