Funzione SCardAddReaderToGroupW (winscard.h)

Articolo
08/27/2023

La funzione SCardAddReaderToGroup aggiunge un lettore a un gruppo di lettura.

Sintassi

LONG SCardAddReaderToGroupW(
  [in] SCARDCONTEXT hContext,
  [in] LPCWSTR      szReaderName,
  [in] LPCWSTR      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 che si aggiunge.

[in] szGroupName

Nome visualizzato del gruppo a cui si aggiunge il lettore.

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

SCardAddReaderToGroup crea automaticamente il gruppo di lettura specificato se non esiste già.

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

Esempio

Nell'esempio seguente viene illustrato come aggiungere un lettore smart card a un gruppo. L'esempio presuppone che lReturn sia una variabile di tipo LONG esistente, che hContext sia un handle valido ricevuto da una chiamata precedente alla funzione SCardEstablishContext e che "MyReader" e "MyReaderGroup" siano noti rispettivamente dal sistema tramite chiamate precedenti alle funzioni SCardIntroduceReader e SCardIntroduceReaderGroup.


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

Nota

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

SCardEstablishContext

SCardIntroduceReader

SCardIntroduceReaderGroup

SCardRemoveReaderFromGroup

Condividi tramite