Condividi tramite


Funzione SCardRemoveReaderFromGroupA (winscard.h)

La funzione SCardRemoveReaderFromGroup rimuove un lettore da un gruppo di lettori esistente. Questa funzione non ha alcun effetto sul lettore.

Sintassi

LONG SCardRemoveReaderFromGroupA(
  [in] SCARDCONTEXT hContext,
  [in] LPCSTR       szReaderName,
  [in] LPCSTR       szGroupName
);

Parametri

[in] hContext

Handle che identifica il contesto di Resource Manager. Il contesto di Resource Manager viene impostato da una chiamata precedente a SCardEstablishContext. Questo parametro non può essere NULL.

[in] szReaderName

Nome visualizzato del lettore da rimuovere.

[in] szGroupName

Nome visualizzato del gruppo da cui rimuovere il lettore.

Valore Significato
SCARD_ALL_READERS
TEXT("SCard$AllReaders\000")
Gruppo utilizzato quando non viene specificato alcun nome di gruppo quando si elencano i lettori. Restituisce un elenco di tutti i lettori, indipendentemente dal gruppo o dai gruppi in cui si trovano i lettori.
SCARD_DEFAULT_READERS
TEXT("SCard$DefaultReaders\000")
Gruppo predefinito a cui vengono aggiunti tutti i lettori quando vengono introdotti nel sistema.
SCARD_LOCAL_READERS
TEXT("SCard$LocalReaders\000")
Valore legacy inutilizzato. Si tratta di un gruppo gestito internamente che non può essere modificato usando le API del gruppo di lettura. Deve essere usata solo per l'enumerazione.
SCARD_SYSTEM_READERS
TEXT("SCard$SystemReaders\000")
Valore legacy inutilizzato. Si tratta di un gruppo gestito internamente che non può essere modificato usando le API del gruppo di lettura. Deve essere usata solo per l'enumerazione.

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 della smart card.

Commenti

Quando l'ultimo lettore viene rimosso da un gruppo, il gruppo viene dimenticato automaticamente.

La funzione SCardRemoveReaderFromGroup è una funzione di gestione del database. Per informazioni su altre funzioni di gestione del database, vedere Funzioni di gestione del database smart card.

Per aggiungere un lettore a un gruppo di lettura, usare SCardAddReaderToGroup.

Esempio

Nell'esempio seguente viene illustrato come rimuovere un lettore dal gruppo.

// Remove a reader from the group.
// lReturn is of type LONG.
// hContext was set by a previous call to SCardEstablishContext.
// The group is automatically forgotten if no readers remain in it.
lReturn = SCardRemoveReaderFromGroup(hContext, 
                                     L"MyReader",
                                     L"MyReaderGroup");
if ( SCARD_S_SUCCESS != lReturn )
    printf("Failed SCardRemoveReaderFromGroup\n");

Nota

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

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

SCardAddReaderToGroup

SCardEstablishContext

SCardForgetCardType

SCardForgetReader

SCardForgetReaderGroup