CardRequestExclusive
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/28/2008
This function requests exclusive access to a specified socket and function pair.
Syntax
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 Value
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
| Header | cardsv2.h |
| Library | Pcc_serv.dll |
| Windows Embedded CE | Windows CE 1.0 and later |