Share via

CardRequestExclusive

  • Article

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 with 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: Cardserv.h.
Link Library: Cardserv.lib.

See Also

CardReleaseExclusive | CARD_EVENT_PARMS

 Last updated on Tuesday, May 18, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.