Функция SCardGetAttrib (winscard.h)

Функция SCardGetAttrib извлекает текущие атрибуты средства чтения для заданного дескриптора. Это не влияет на состояниесредства чтения, драйвера или карта.

Синтаксис

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

Параметры

[in] hCard

Значение ссылки, возвращаемое из SCardConnect.

[in] dwAttrId

Идентификатор получаемого атрибута . В следующей таблице перечислены возможные значения для dwAttrId. Эти значения доступны только для чтения. Обратите внимание, что поставщики могут поддерживать не все атрибуты.

[out] pbAttr

Указатель на буфер, который получает атрибут, идентификатор которого указан в dwAttrId. Если это значение равно NULL, SCardGetAttrib игнорирует длину буфера, указанную в pcbAttrLen, записывает длину буфера, который был бы возвращен, если бы этот параметр не имел значения NULL в pcbAttrLen, и возвращает код успешного выполнения.

[in, out] pcbAttrLen

Длина буфера pbAttr в байтах и получает фактическую длину полученного атрибута. Если длина буфера указана как SCARD_AUTOALLOCATE, то pbAttr преобразуется в указатель на указатель байта и получает адрес блока памяти, содержащего атрибут . Этот блок памяти должен быть освобожден с помощью SCardFreeMemory.

Возвращаемое значение

Эта функция возвращает различные значения в зависимости от того, является ли она успешной или неудачной.

Комментарии

Функция SCardGetAttrib является функцией прямого доступа карта. Дополнительные сведения о других функциях прямого доступа см. в разделе Функции прямого доступа к карточкам.

Примеры

В следующем примере показано, как получить атрибут для карта средства чтения. В примере предполагается, что hCardHandle является допустимым дескриптором, полученным из предыдущего вызова функции 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 );
}

Требования

См. также раздел

SCardConnect

SCardFreeMemory

SCardSetAttrib