Funzione SCardIntroduceCardTypeW (winscard.h)

La funzione SCardIntroduceCardType introduce una smart card al sottosistema smart card (per l'utente attivo) aggiungendolo al database smart card.

Sintassi

LONG SCardIntroduceCardTypeW(
  [in]           SCARDCONTEXT hContext,
  [in]           LPCWSTR      szCardName,
  [in, optional] LPCGUID      pguidPrimaryProvider,
  [in, optional] LPCGUID      rgguidInterfaces,
  [in]           DWORD        dwInterfaceCount,
  [in]           LPCBYTE      pbAtr,
  [in]           LPCBYTE      pbAtrMask,
  [in]           DWORD        cbAtrLen
);

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] szCardName

Nome in base al quale l'utente può riconoscere la scheda.

[in, optional] pguidPrimaryProvider

Puntatore all'identificatore (GUID) per il provider di servizi primario della smart card.

[in, optional] rgguidInterfaces

Matrice di identificatori (GUID) che identificano le interfacce supportate dalla smart card.

[in] dwInterfaceCount

Numero di identificatori nella matrice rgguidInterfaces .

[in] pbAtr

Stringa ATR che può essere usata per scopi corrispondenti quando si esegue una query sul database della smart card (per altre informazioni, vedere SCardListCards). La lunghezza di questa stringa è determinata dall'analisi di ATR normale.

[in] pbAtrMask

Maschera di bit facoltativa da usare quando si confrontano gli ATR delle smart card forniti in pbAtr. Se questo valore non è NULL, deve puntare a una stringa di byte la stessa lunghezza della stringa ATR fornita in pbAtr. Quando una stringa ATR specificata viene confrontata con ATR fornita inpbAtr, corrisponde se e solo se A & M = pbAtr, dove M è la maschera fornita e & rappresenta and bit per bit.

[in] cbAtrLen

Lunghezza della maschera ATR e facoltativa ATR. Se questo valore è zero, la lunghezza dell'ATR viene determinata dall'analisi di ATR normale. Questo valore non può essere zero se viene specificato un valore pbAtr .

Valore restituito

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

Commenti

Questa funzione non viene reindirizzata, ma la chiamata alla funzione quando all'interno di una sessione desktop remoto non verrà generato un errore. Significa solo che il risultato sarà dal computer remoto anziché dal computer locale.

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

Per rimuovere una smart card, usare SCardForgetCardType.

Esempio

Nell'esempio seguente viene illustrato come introdurre un tipo di scheda. L'esempio presuppone che hContext sia un handle valido ottenuto da una chiamata precedente alla funzione SCardEstablishContext .

GUID  MyGuid = { 0xABCDEF00,
                 0xABCD,
                 0xABCD,
                 0xAA, 0xBB, 0xCC, 0xDD,
                 0xAA, 0xBB, 0xCC, 0xDD };

static const BYTE MyATR[] =     { 0xaa, 0xbb, 0xcc, 0x00, 0xdd };
static const BYTE MyATRMask[] = { 0xff, 0xff, 0xff, 0x00, 0xff};

LONG            lReturn;

lReturn = SCardIntroduceCardType(hContext, 
                                 L"MyCardName",
                                 &MyGuid,
                                 NULL,    // No interface array
                                 0,       // Interface count = 0
                                 MyATR,
                                 MyATRMask,
                                 sizeof(MyATR));
if ( SCARD_S_SUCCESS != lReturn )
    printf("Failed SCardIntroduceCardType\n");

Requisiti

Vedi anche

SCardEstablishContext

SCardForgetCardType

SCardIntroduceReader

SCardIntroduceReaderGroup

SCardListCardCards