Fungsi SCardStatusA (winscard.h)

Fungsi SCardStatus menyediakan status saat ini dari kartu pintar di pembaca . Anda dapat memanggilnya kapan saja setelah panggilan berhasil ke SCardConnect dan sebelum panggilan berhasil ke SCardDisconnect. Ini tidak memengaruhi status pembaca atau driver pembaca .

Sintaksis

LONG SCardStatusA(
  [in]                SCARDHANDLE hCard,
  [out]               LPSTR       mszReaderNames,
  [in, out, optional] LPDWORD     pcchReaderLen,
  [out, optional]     LPDWORD     pdwState,
  [out, optional]     LPDWORD     pdwProtocol,
  [out]               LPBYTE      pbAtr,
  [in, out, optional] LPDWORD     pcbAtrLen
);

Parameter

[in] hCard

Nilai referensi yang dikembalikan dari SCardConnect.

[out] mszReaderNames

Daftar nama tampilan (beberapa string) yang diketahui pembaca yang saat ini terhubung.

[in, out, optional] pcchReaderLen

Pada input, memasok panjang buffer szReaderName.

Pada output, menerima panjang aktual (dalam karakter) daftar nama pembaca, termasuk karakter NULL berikutnya. Jika panjang buffer ini ditentukan sebagai SCARD_AUTOALLOCATE, maka szReaderName dikonversi ke pointer ke penunjuk byte, dan menerima alamat blok memori yang berisi struktur multi-string.

[out, optional] pdwState

Status saat ini kartu pintar di pembaca. Setelah berhasil, ia menerima salah satu indikator status berikut.

[out, optional] pdwProtocol

Protokol saat ini, jika ada. Nilai yang dikembalikan bermakna hanya jika nilai yang dikembalikan dari pdwState SCARD_SPECIFICMODE.

[out] pbAtr

Arahkan ke buffer 32 byte yang menerima string ATR dari kartu yang saat ini dimasukkan, jika tersedia.

[in, out, optional] pcbAtrLen

Pada input, memasok panjang buffer pbAtr . Pada output, menerima jumlah byte dalam string ATR (maksimum 32 byte). Jika panjang buffer ini ditentukan sebagai SCARD_AUTOALLOCATE, maka pbAtr dikonversi ke pointer ke penunjuk byte, dan menerima alamat blok memori yang berisi struktur multi-string.

Mengembalikan nilai

Jika fungsi berhasil memberikan status kartu pintar saat ini dipembaca , nilai yang dikembalikan adalah SCARD_S_SUCCESS.

Jika fungsi gagal, fungsi akan mengembalikan kode kesalahan. Untuk informasi selengkapnya, lihat Nilai Pengembalian Kartu Pintar.

Komentar

Fungsi SCardStatus adalah kartu pintar dan fungsi akses pembaca . Untuk informasi tentang fungsi akses lainnya, lihat Smart Card dan Reader Access Functions.

Contoh

Contoh berikut menunjukkan cara menentukan status kartu pintar.

WCHAR           szReader[200];
DWORD           cch = 200;
BYTE            bAttr[32];
DWORD           cByte = 32;
DWORD           dwState, dwProtocol;
LONG            lReturn;

// Determine the status.
// hCardHandle was set by an earlier call to SCardConnect.
lReturn = SCardStatus(hCardHandle,
                      szReader,
                      &cch,
                      &dwState,
                      &dwProtocol,
                      (LPBYTE)&bAttr,
                      &cByte); 

if ( SCARD_S_SUCCESS != lReturn )
{
    printf("Failed SCardStatus\n");
    exit(1);     // or other appropriate action
}

// Examine retrieved status elements.
// Look at the reader name and card state.
printf("%S\n", szReader );
switch ( dwState )
{
    case SCARD_ABSENT:
        printf("Card absent.\n");
        break;
    case SCARD_PRESENT:
        printf("Card present.\n");
        break;
    case SCARD_SWALLOWED:
        printf("Card swallowed.\n");
        break;
    case SCARD_POWERED:
        printf("Card has power.\n");
        break;
    case SCARD_NEGOTIABLE:
        printf("Card reset and waiting PTS negotiation.\n");
        break;
    case SCARD_SPECIFIC:
        printf("Card has specific communication protocols set.\n");
        break;
    default:
        printf("Unknown or unexpected card state.\n");
        break;
}

Persyaratan

Lihat juga

SCardConnect

SCardDisconnect