Funzione SCardListReadersA (winscard.h)

La funzione SCardListReaders fornisce l'elenco dei lettori all'interno di un set di gruppi di lettura denominati, eliminando i duplicati.

Il chiamante fornisce un elenco di gruppi di lettori e riceve l'elenco dei lettori all'interno dei gruppi denominati. I nomi dei gruppi non riconosciuti vengono ignorati. Questa funzione restituisce solo i lettori all'interno dei gruppi denominati attualmente collegati al sistema e disponibili per l'uso.

Sintassi

LONG SCardListReadersA(
  [in]           SCARDCONTEXT hContext,
  [in, optional] LPCSTR       mszGroups,
  [out]          LPSTR        mszReaders,
  [in, out]      LPDWORD      pcchReaders
);

Parametri

[in] hContext

Handle che identifica il contesto di Resource Manager per la query. Il contesto di Resource Manager può essere impostato da una chiamata precedente a SCardEstablishContext.

Se questo parametro è impostato su NULL, la ricerca dei lettori non è limitata ad alcun contesto.

[in, optional] mszGroups

Nomi dei gruppi di lettura definiti al sistema, come stringa multipla. Usare un valore NULL per elencare tutti i lettori del sistema , ovvero il gruppo SCard$AllReaders.

[out] mszReaders

Stringa multipla che elenca i lettori di schede all'interno dei gruppi di lettori forniti. Se questo valore è NULL, SCardListReaders ignora la lunghezza del buffer fornita in pcchReaders, scrive la lunghezza del buffer che sarebbe stato restituito se questo parametro non fosse stato NULL in pcchReaders e restituisce un codice di operazione riuscita.

[in, out] pcchReaders

Lunghezza del buffer mszReaders in caratteri. Questo parametro riceve la lunghezza effettiva della struttura a più stringhe, inclusi tutti i caratteri Null finali. Se la lunghezza del buffer viene specificata come SCARD_AUTOALLOCATE, mszReaders viene convertita in un puntatore a un puntatore a byte e riceve l'indirizzo di un blocco di memoria contenente la struttura a più stringhe. Questo blocco di memoria deve essere deallocato con SCardFreeMemory.

Valore restituito

Questa funzione restituisce valori diversi a seconda che abbia esito positivo o negativo.

Commenti

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

Esempio

L'esempio seguente mostra l'elenco dei lettori.

LPTSTR          pmszReaders = NULL;
LPTSTR          pReader;
LONG            lReturn, lReturn2;
DWORD           cch = SCARD_AUTOALLOCATE;

// Retrieve the list the readers.
// hSC was set by a previous call to SCardEstablishContext.
lReturn = SCardListReaders(hSC,
                           NULL,
                           (LPTSTR)&pmszReaders,
                           &cch );
switch( lReturn )
{
    case SCARD_E_NO_READERS_AVAILABLE:
        printf("Reader is not in groups.\n");
        // Take appropriate action.
        // ...
        break;

    case SCARD_S_SUCCESS:
        // Do something with the multi string of readers.
        // Output the values.
        // A double-null terminates the list of values.
        pReader = pmszReaders;
        while ( '\0' != *pReader )
        {
            // Display the value.
            printf("Reader: %S\n", pReader );
            // Advance to the next value.
            pReader = pReader + wcslen((wchar_t *)pReader) + 1;
        }
        // Free the memory.
        lReturn2 = SCardFreeMemory( hSC,
                                   pmszReaders );
        if ( SCARD_S_SUCCESS != lReturn2 )
            printf("Failed SCardFreeMemory\n");
        break;

default:
        printf("Failed SCardListReaders\n");
        // Take appropriate action.
        // ...
        break;
}

Requisiti

Vedi anche

SCardEstablishContext

SCardFreeMemory

SCardGetProviderId

SCardListCardCards

SCardListInterfaces

SCardListReaderGroups