CardRequestSocketMask
.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.")
9/8/2008
Essa função associa um par Soquete e função com uma máscara evento para o driver. Placa serviços e restringe suas retornos de chamada futuros o driver para esses associado com a máscara evento passada para essa função.
Syntax
STATUS CardRequestSocketMask(
CARD_CLIENT_HANDLE hCardClient,
CARD_SOCKET_HANDLE hSock,
UINT16 fEventMask
);
Parameters
- hCardClient
[no] Alça obtido a partir de CardRegisterClient função.
- hSock
[no] Identificador para um par Soquete e função.
fEventMask
[no] Especifica um máscara de bits indicando os eventos que disparador um callback.A seguinte tabela mostra os eventos cartão PC que são permitidos.
Máscara de evento Descrição EVENT_MASK_WRITE_PROTECT
Estado Write-Protect
EVENT_MASK_CARD_LOCK
Estado bloqueio do cartão
EVENT_MASK_EJECT_REQ
Solicitação de ejeção
EVENT_MASK_INSERT_REQ
Solicitação de inserção
EVENT_MASK_BATTERY_DEAD
Fila de inatividade da bateria
EVENT_MASK_BATTERY_LOW
Bateria baixa
EVENT_MASK_CARD_READY
Alteração pronta
EVENT_MASK_CARD_DETECT
Detecção de cartão
EVENT_MASK_POWER_MGMT
Alteração gerenciamento de energia
EVENT_MASK_RESET
Redefinir cartão
EVENT_MASK_STATUS_CHANGE
Interrupção alteração status Card-generated
Return Value
CERR_SUCCESS indica sucesso. Um do seguinte valores indica falha:
- CERR_BAD_HANDLE
Indica que o identificador driver especificado para hCardClient não é válido.
- CERR_BAD_SOCKET
Indica que o identificador Soquete especificado para hSock não é válido.
- CERR_OUT_OF_RESOURCE
Indica que memória insuficiente disponível para criar uma nova máscara evento.
Remarks
Uma máscara evento não deve ser confundida com a máscara evento global, que diz respeito a todos os soquetes e é definida por CardRegisterClient.
O CardSetEventMask função pode alteração tanto uma máscara Socket-specific evento ou a máscara especificada por CardRegisterClient.
As máscaras evento EVENT_MASK_POWER_MGMT, EVENT_MASK_RESET e EVENT_MASK_STATUS_CHANGE não devem ser geradas por Soquete si mesmo.
Requirements
| Header | cardserv.h |
| Library | Cardserv.lib |
| Windows Embedded CE | Windows CE 1.0 and later |