Fungsi SCardIsValidContext (winscard.h)

  • Artikel

Fungsi SCardIsValidContext menentukan apakah handel konteks kartu pintar valid.

Sintaks

LONG SCardIsValidContext(
  [in] SCARDCONTEXT hContext
);

Parameter

[in] hContext

Menangani yang mengidentifikasi konteks resource manager. Konteks resource manager dapat diatur oleh panggilan sebelumnya ke SCardEstablishContext.

Mengembalikan nilai

Fungsi ini mengembalikan salah satu nilai berikut.

Menampilkan kode Deskripsi
SCARD_S_SUCCESS
 Parameter hContext valid.
ERROR_INVALID_HANDLE
 Parameter hContext tidak valid.
Nilai lain
 Kode kesalahan. Untuk informasi selengkapnya, lihat Nilai Pengembalian Kartu Pintar.

Keterangan

Panggil fungsi ini untuk menentukan apakah handel konteks kartu pintar masih valid. Setelah handel konteks kartu pintar diatur oleh SCardEstablishContext, mungkin menjadi tidak valid jika layanan resource manager telah dimatikan.

Contoh

Contoh berikut menunjukkan menentukan apakah handel konteks kartu pintar valid.

// Check the smart card context handle.
// hContext was set previously by SCardEstablishContext.

LONG    lReturn;
lReturn = SCardIsValidContext(hContext);
if ( SCARD_S_SUCCESS != lReturn )
{
    // Function failed; check return value.
    if ( ERROR_INVALID_HANDLE == lReturn )
        printf("Handle is invalid\n");
    else
    {
        // Some unexpected error occurred; report and bail out.
        printf("Failed SCardIsValidContext - %x\n", lReturn);
        exit(1);  // Or other appropriate error action.
    }
}
else
{
    // Handle is valid; proceed as needed.
    // ...
}

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header winscard.h
Pustaka Winscard.lib
DLL Winscard.dll

Lihat juga

SCardEstablishContext