CardRequestExclusive (Windows CE 5.0)
This function requests exclusive access to a specified socket and function pair.
STATUS CardRequestExclusive(CARD_CLIENT_HANDLE hCardClient,CARD_SOCKET_HANDLE hSocket);
Parameters
- hCardClient
[in] Client handle obtained from the CardRegisterClient function. - hSocket
[in] Handle to a socket and function pair.
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 not valid. - CERR_BAD_SOCKET
Indicates that the socket identifier specified for hSocket is not valid. - CERR_NO_CARD
Indicates that no PC Card is inserted.
Remarks
This function signals card services to issue a series of callback events as it negotiates for approval from each registered driver. First, card services sends a CE_EXCLUSIVE_REQUEST event code to all registered drivers to determine if they allow exclusive use. If all drivers approve the request, card services sends each driver a CE_CARD_REMOVAL event code. Finally, it sends a CE_CARD_INSERTION event code to the requesting driver followed by a CE_EXCLUSIVE_COMPLETE event code. If any drivers do not approve, card services sends the requesting driver a CE_EXCLUSIVE_COMPLETE event code with a failing status in the Parm1 member of the CARD_EVENT_PARMS structure.
Requirements
OS Versions: Windows CE 1.0 and later.
Header: Cardsv2.h.
Link Library: Pcc_serv.dll
See Also
CardReleaseExclusive | CARD_EVENT_PARMS
Send Feedback on this topic to the authors