Funzione SCardIntroduceReaderGroupW (winscard.h)
La funzione SCardIntroduceReaderGroup introduce un gruppo di lettori nel sottosistema smart card . Tuttavia, il gruppo di lettura non viene creato fino a quando non viene specificato il gruppo quando si aggiunge un lettore al database di smart card.
Sintassi
LONG SCardIntroduceReaderGroupW(
[in] SCARDCONTEXT hContext,
[in] LPCWSTR 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 lettori.
Valore restituito
Questa funzione restituisce valori diversi a seconda che abbia esito positivo o negativo.
Codice restituito | Descrizione |
---|---|
|
SCARD_S_SUCCESS. |
|
Codice di errore. Per altre informazioni, vedere Valori restituiti della smart card. |
Commenti
La funzione SCardIntroduceReaderGroup viene fornita per la compatibilità delle specifiche PC/SC. I gruppi di lettura non vengono archiviati fino a quando 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
L'esempio seguente illustra l'introduzione di un gruppo di lettori di 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 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 |