CardGetEventMask
This function retrieves either the driver's global event mask or the event mask for a particular socket and function. The event mask specifies the events that trigger a callback.
STATUS CardGetEventMask(
CARD_CLIENT_HANDLE hCardClient,
PCARD_EVENT_MASK_PARMS pMaskParms
);
Parameters
- hCardClient
[in] Client handle obtained from the CardRegisterClient function. - pMaskParms
[out] Pointer to a CARD_EVENT_MASK_PARMS structure.
Return Values
| Return value | Description |
|---|---|
| CERR_SUCCESS | Indicates success. |
| CERR_BAD_ARGS | Indicates failure. Indicates that the pointer specified for pMaskParms is not valid. |
| CERR_BAD_HANDLE | Indicates failure. Indicates that the driver handle specified for hCardClient is not valid. |
| CERR_BAD_SOCKET | Indicates failure. Indicates that the identifier specified for the hSocket member of CARD_EVENT_MASK_PARMS is not valid or that no PC Card is inserted in the socket. |
Remarks
If a stream interface driver used the CardRequestSocketMask function to associate a socket and function pair with an event mask, this function retrieves the event mask for the specified socket and function; otherwise, it retrieves the global event mask as set initially by CardRegisterClient.
This function returns the current event mask in the fEventMask member of CARD_EVENT_MASK_PARMS. If this function returns a global event mask, it ignores the structure's socket identifier member hSocket.
Requirements
OS Versions: Windows CE 1.0 and later.
Header: Cardserv.h.
Link Library: Cardserv.lib.
See Also
CARD_EVENT_MASK_PARMS | CardRequestSocketMask | CardSetEventMask
Last updated on Tuesday, May 18, 2004
© 1992-2003 Microsoft Corporation. All rights reserved.