CardSetEventMask

Other versions of this page are also available for the following:

• Windows Embedded CE 6.0 R3

8/28/2008

This function sets either the driver's global event mask, set initially by the CardRegisterClient function, 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
  [in] Handle obtained from CardRegisterClient.

• pMaskParms
  [in] Pointer to a CARD_EVENT_MASK_PARMS structure.

Return Value

CERR_SUCCESS indicates success. One of the following values indicates failure:

• CERR_BAD_ARGS
  Indicates that the pointer specified for pMaskParms is not valid.

• CERR_BAD_HANDLE
  Indicates that the driver handle specified for hCardClient is not valid.

• CERR_BAD_SOCKET
  Indicates that the socket identifier specified for the hSocket member of CARD_EVENT_MASK_PARMS is not valid or that no PC Card is inserted.

Remarks

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

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

Requirements

Header	cardsv2.h
Library	Pcc_serv.dll
Windows Embedded CE	Windows CE 1.0 and later

See Also

Reference

CARD_EVENT_MASK_PARMS
CardGetEventMask
CardRequestSocketMask
CardRegisterClient