Funzione SCardForgetReaderGroupA (winscard.h)

Articolo
08/27/2023

La funzione SCardForgetReaderGroup rimuove un gruppo di lettori di smart card introdotto in precedenza dal sottosistema smart card. Anche se questa funzione cancella automaticamente tutti i lettori dal gruppo, non influisce sull'esistenza dei singoli lettori nel database.

Sintassi

LONG SCardForgetReaderGroupA(
  [in] SCARDCONTEXT hContext,
  [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] szGroupName

Nome visualizzato del gruppo di lettura da rimuovere. I gruppi di lettura definiti dal sistema non possono essere rimossi dal database.

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

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

Esempio

Nell'esempio seguente viene illustrato come rimuovere un gruppo di lettori dal sistema. L'esempio presuppone che lReturn sia una variabile esistente di tipo LONG e che hContext sia un handle valido per un contesto di gestione risorse ottenuto in precedenza da una chiamata alla funzione SCardEstablishContext .


lReturn = SCardForgetReaderGroup(hContext, 
                                 L"MyReaderGroup");
if ( SCARD_S_SUCCESS != lReturn )
    printf("Failed SCardForgetReaderGroup\n");

Nota

L'intestazione winscard.h definisce SCardForgetReaderGroup 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

Requisito	Valore
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

SCardEstablishContext

SCardForgetCardType

SCardForgetReader

SCardIntroduceReaderGroup

Condividi tramite