Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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