Condividi tramite


Funzione SCardIntroduceReaderGroupA (winscard.h)

La funzione SCardIntroduceReaderGroup introduce un gruppo di lettori al sottosistema smart card . Tuttavia, il gruppo di lettura non viene creato finché non viene specificato il gruppo quando si aggiunge un lettore al database della smart card.

Sintassi

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

Parametri

[in] hContext

Fornisce l'handle che identifica il contesto di Resource Manager. Il contesto di Resource Manager viene impostato da una chiamata precedente alla funzione SCardEstablishContext . Se questo parametro è NULL, l'ambito di Resource Manager è SCARD_SCOPE_SYSTEM.

[in] szGroupName

Specifica il nome visualizzato da assegnare al nuovo gruppo di lettura.

Valore Significato
SCARD_ALL_READERS
TEXT("SCard$AllReaders\000")
Gruppo usato quando non viene fornito 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 usato 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 usato 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 smart card.

Commenti

La funzione SCardIntroduceReaderGroup è disponibile per la compatibilità delle specifiche PC/SC. I gruppi di lettura non vengono archiviati finché non viene aggiunto un lettore al gruppo.

La funzione SCardIntroduceReaderGroup è una funzione di gestione del database. Per una descrizione di altre funzioni di gestione del database, vedere Funzioni di gestione del database smart card.

Per rimuovere un gruppo di lettura, usare SCardForgetReaderGroup.

Esempio

Nell'esempio seguente viene illustrato l'introduzione di un gruppo di lettura smart card.

// Introduce the reader group.
// lReturn is of type LONG.
// hContext was set by a previous call to SCardEstablishContext.
lReturn = SCardIntroduceReaderGroup(hContext, 
                                    L"MyReaderGroup");
if ( SCARD_S_SUCCESS != lReturn )
    printf("Failed SCardIntroduceReaderGroup\n");

Nota

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

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

SCardAddReaderToGroup

SCardEstablishContext

SCardForgetReaderGroup

SCardIntroduceCardType

SCardIntroduceReader