Funzione SCardGetAttrib (winscard.h)

La funzione SCardGetAttrib recupera gli attributi correnti del lettore per l'handle specificato. Non influisce sullo stato del lettore, del driver o della scheda.

Sintassi

LONG SCardGetAttrib(
  [in]      SCARDHANDLE hCard,
  [in]      DWORD       dwAttrId,
  [out]     LPBYTE      pbAttr,
  [in, out] LPDWORD     pcbAttrLen
);

Parametri

[in] hCard

Valore di riferimento restituito da SCardConnect.

[in] dwAttrId

Identificatore dell'attributo da ottenere. Nella tabella seguente sono elencati i valori possibili per dwAttrId. I valori sono di sola lettura. Si noti che i fornitori potrebbero non supportare tutti gli attributi.

[out] pbAttr

Puntatore a un buffer che riceve l'attributo il cui ID viene fornito in dwAttrId. Se questo valore è NULL, SCardGetAttrib ignora la lunghezza del buffer fornita in pcbAttrLen, scrive la lunghezza del buffer che sarebbe stato restituito se questo parametro non fosse stato NULL in pcbAttrLen e restituisce un codice di operazione riuscita.

[in, out] pcbAttrLen

Lunghezza del buffer pbAttr in byte e riceve la lunghezza effettiva dell'attributo ricevuto Se la lunghezza del buffer viene specificata come SCARD_AUTOALLOCATE, pbAttr viene convertita in un puntatore a un puntatore a un puntatore a byte e riceve l'indirizzo di un blocco di memoria contenente l'attributo . 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 SCardGetAttrib è una funzione di accesso diretto alla scheda. Per altre informazioni su altre funzioni di accesso diretto, vedere Funzioni di accesso diretto alle schede.

Esempio

Nell'esempio seguente viene illustrato come recuperare un attributo per un lettore di schede. L'esempio presuppone che hCardHandle sia un handle valido ottenuto da una chiamata precedente alla funzione SCardConnect .

LPBYTE   pbAttr = NULL;
DWORD    cByte = SCARD_AUTOALLOCATE;
DWORD    i;
LONG     lReturn;

lReturn = SCardGetAttrib(hCardHandle,
                         SCARD_ATTR_VENDOR_NAME,
                         (LPBYTE)&pbAttr,
                         &cByte);
if ( SCARD_S_SUCCESS != lReturn )
{
    if ( ERROR_NOT_SUPPORTED == lReturn )
        printf("Value not supported\n");
    else
    {
        // Some other error occurred.
        printf("Failed SCardGetAttrib - %x\n", lReturn);
        exit(1);  // Or other appropriate action
    }
}
else
{
    // Output the bytes.
    for (i = 0; i < cByte; i++)
        printf("%c", *(pbAttr+i));
    printf("\n");

    // Free the memory when done.
    // hContext was set earlier by SCardEstablishContext
    lReturn = SCardFreeMemory( hContext, pbAttr );
}

Requisiti

Vedi anche

SCardConnect

SCardFreeMemory

SCardSetAttrib