CardRequestSocketMask
This function associates a socket and function pair with an event mask for the driver. Card Services then restricts its future callbacks to the driver to those associated with the event mask passed to this function.
STATUS CardRequestSocketMask(
CARD_CLIENT_HANDLE hCardClient
CARD_SOCKET_HANDLE hSock
UINT16 fEventMask );
Parameters
- hCardClient
Handle obtained from the CardRegisterClient function. - hSock
Handle to a socket and function pair. - fEventMask
Specifies a bitmask indicating the events that trigger a callback. The allowable card events are listed in the Cardserv.h header file.
Return Values
CERR_SUCCESS indicates success. One of the following values indicates failure:
- CERR_BAD_HANDLE
Indicates that the driver handle specified for hCardClient is invalid. - CERR_BAD_SOCKET
Indicates that the socket identifier specified for hSock is invalid. - CERR_OUT_OF_RESOURCE
Indicates that insufficient memory is available to create a new event mask.
Remarks
An event mask should not be confused with the global event mask, which pertains to all sockets and is set by CardRegisterClient.
The CardSetEventMask function can change either a socket-specific event mask or the mask specified by CardRegisterClient.
Driver name
PCMCIA
Requirements
| Runs on | Versions | Defined in | Include | Link to |
|---|---|---|---|---|
| Windows CE OS | 1.0 and later |
Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.
See Also
Last updated on Tuesday, July 13, 2004
© 1992-2000 Microsoft Corporation. All rights reserved.