SVR5 and SCO OpenServer 5

RequestSocketMask(D3pccard)

RequestSocketMask -- arrange to receive socket status change notifications

Synopsis (Unsupported service)

   #include <sys/types.h>
   #include <sys/lcs.h>
   #include <sys/lss.h>
   
   int CardServices (RequestSocketMask, ClientHandle_t *pClientHandle,
                     int n1, int RelReqSocketMaskLen,
                     RelReqSocketMask_t *pRelReqSocketMask,
   	   	  rm_key_t key);

Description

RequestSocketMask( ) is invoked by the Client to receive socket status change notifications from CardServices( ).

Arguments

pClientHandle: Pointer to a ClientHandle(D4pccard) structure.
n1: NULL
RelReqSocketMaskLen: Length of the RelReqSocketMask(D4pccard) structure.
pRelReqSocketMask: Pointer to a RelReqSocketMask(D4pccard) structure.
key: Resource manager key.

Return values

UNSUPPORTED_SERVICE: Service not currently supported.

Usage

If the Client also has events enabled in its global event mask, CardServices sends double socket status change notifications. ReleaseSocketMask(D3pccard) undoes RequestSocketMask. A GetEventMask(D3pccard) or SetEventMask(D3pccard) request will be rejected unless a RequestSocketMask has already been effected for the socket.

Context and synchronization

Interrupt, initialization, or user context

Hardware applicability

All

Version applicability

pccard: 3

References

ClientHandle(D4pccard), RelReqSocketMask(D4pccard)