CardSetEventMask

The CardSetEventMask function sets either the driver's global event mask, set initially by CardRegisterClient, or an event mask for a specified socket and function pair as specified in the CARD_EVENT_MASK_PARMS structure.

Syntax

STATUS CardSetEventMask( CARD_CLIENT_HANDLE hCardClient CARD_EVENT_MASK_PARMS pMaskParms );

Parameters

hCardClient: Specifies a client handle obtained from CardRegisterClient.
pMaskParms: Points to a CARD_EVENT_MASK_PARMS structure.

Return Values

If the function succeeds, the return value is CERR_SUCCESS; otherwise, it is one of the following values:

Value	Description
CERR_BAD_ARGS	Indicates the pointer specified for pMaskParms is invalid.
CERR_BAD_HANDLE	Indicates the driver handle specified for hCardClient is invalid.
CERR_BAD_SOCKET	Indicates the socket identifier specified for the hSocket member of the CARD_EVENT_MASK_PARMS structure is invalid, or the PC Card is not inserted.

Remarks

If the global event mask is requested, then the socket identifier in the CARD_EVENT_MASK_PARMS structure is ignored.

To specify event masks for use with a particular socket, call CardRequestSocketMask.