Funzione SCardGetStatusChangeW (winscard.h)

La funzione SCardGetStatusChange blocca l'esecuzione fino alla disponibilità corrente delle schede in un set specifico di modifiche ai lettori.

Il chiamante fornisce un elenco di lettori da monitorare da una matrice SCARD_READERSTATE e dalla quantità massima di tempo (in millisecondi) che è disposto ad attendere che si verifichi un'azione su uno dei lettori elencati. Si noti che SCardGetStatusChange usa il valore fornito dall'utente nei membri dwCurrentState della matrice rgReaderStatesSCARD_READERSTATE come definizione dello stato corrente dei lettori. La funzione restituisce quando si verifica una modifica della disponibilità, dopo aver compilato i membri dwEventState di rgReaderStates in modo appropriato.

Sintassi

LONG SCardGetStatusChangeW(
  [in]      SCARDCONTEXT         hContext,
  [in]      DWORD                dwTimeout,
  [in, out] LPSCARD_READERSTATEW rgReaderStates,
  [in]      DWORD                cReaders
);

Parametri

[in] hContext

Handle che identifica il contesto di Resource Manager. Il contesto di Resource Manager viene impostato da una chiamata precedente alla funzione SCardEstablishContext .

[in] dwTimeout

Quantità massima di tempo, in millisecondi, per attendere un'azione. Un valore pari a zero causa la restituzione immediata della funzione. Un valore di INFINITE causa il timeout di questa funzione.

[in, out] rgReaderStates

Matrice di strutture SCARD_READERSTATE che specificano i lettori di watch e che ricevono il risultato.

Per ricevere una notifica all'arrivo di un nuovo lettore smart card, impostare il membro szReader di una struttura di SCARD_READERSTATE su "\\? PnP?\Notification" e imposta tutti gli altri membri di tale struttura su zero.

Importante Ogni membro di ogni struttura in questa matrice deve essere inizializzato su zero e quindi impostato su valori specifici in base alle esigenze. Se questa operazione non viene eseguita, la funzione avrà esito negativo in situazioni che coinvolgono lettori di schede remote.

 

[in] cReaders

Numero di elementi nella matrice rgReaderStates .

Valore restituito

Questa funzione restituisce valori diversi a seconda che abbia esito positivo o negativo.

Codice restituito	Descrizione
Success	SCARD_S_SUCCESS.
Operazioni non riuscite	Codice di errore. Per altre informazioni, vedere Valori restituiti smart card.

Commenti

La funzione SCardGetStatusChange è una funzione di rilevamento smart card . Per altre informazioni sulle altre funzioni di rilevamento, vedere Funzioni di rilevamento smart card.

Esempio

Per informazioni su come chiamare questa funzione, vedere l'esempio in SCardLocateCards.

Nota

L'intestazione winscard.h definisce SCardGetStatusChange come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winscard.h
Libreria	Winscard.lib
DLL	Winscard.dll

Vedi anche

SCARD_READERSTATE

SCardCancel

SCardEstablishContext

SCardLocateCards