Share via

CardSetEventMask

  • Article

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.

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 Values

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

OS Versions: Windows CE 1.0 and later.
Header: Cardserv.h.
Link Library: Cardserv.lib.

See Also

CARD_EVENT_MASK_PARMS | CardGetEventMask | CardRequestSocketMask | CardRegisterClient

 Last updated on Tuesday, May 18, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.