Funzione SCardListInterfacesA (winscard.h)

Articolo
03/08/2023

La funzione SCardListInterfaces fornisce un elenco di interfacce fornite da una determinata scheda.

Il chiamante fornisce il nome di una smart card introdotta in precedenza nel sottosistema e riceve l'elenco di interfacce supportate dalla scheda.

Sintassi

LONG SCardListInterfacesA(
  [in]      SCARDCONTEXT hContext,
  [in]      LPCSTR       szCard,
  [out]     LPGUID       pguidInterfaces,
  [in, out] LPDWORD      pcguidInterfaces
);

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. Questo parametro non può essere NULL.

[in] szCard

Nome della smart card già introdotta nel sottosistema smart card.

[out] pguidInterfaces

Matrice di identificatori di interfaccia (GUID) che indicano le interfacce supportate dalla smart card. Se questo valore è NULL, SCardListInterfaces ignora la lunghezza della matrice fornita in pcguidInterfaces, restituendo le dimensioni della matrice che sarebbero state restituite se questo parametro non fosse stato NULL per pcguidInterfaces e un codice di operazione riuscita.

[in, out] pcguidInterfaces

Dimensioni della matrice pcguidInterfaces e riceve le dimensioni effettive della matrice restituita. Se le dimensioni della matrice vengono specificate come SCARD_AUTOALLOCATE, pcguidInterfaces viene convertito in un puntatore a un puntatore GUID e riceve l'indirizzo di un blocco di memoria contenente la matrice. Questo blocco di memoria deve essere deallocato con SCardFreeMemory.

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

Questa funzione non viene reindirizzata, ma la chiamata alla funzione quando si tenta una sessione desktop remoto non genererà un errore. Significa solo che il risultato sarà dal computer remoto anziché dal computer locale.

La funzione SCardListInterfaces è 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 delle interfacce per una smart card.

LPGUID          pGuids = NULL;
LONG            lReturn;
DWORD           cGuid = SCARD_AUTOALLOCATE;

// Retrieve the list of interfaces.
lReturn = SCardListInterfaces(NULL,
                              (LPCSTR) "MyCard",
                              (LPGUID)&pGuids,
                              &cGuid );
if ( SCARD_S_SUCCESS != lReturn )
{
    printf("Failed SCardListInterfaces\n");
    exit(1);   // Or other appropriate action
}

if ( 0 != cGuid )
{
    // Do something with the array of Guids.
    // Remember to free pGuids when done (by SCardFreeMemory).
    // ...
}

Nota

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


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