Metode ISCardDatabase::ListCardInterfaces

[Metode ListCardInterfaces tersedia untuk digunakan dalam sistem operasi yang ditentukan di bagian Persyaratan. Ini tidak tersedia untuk digunakan di Windows Server 2003 dengan Paket Layanan 1 (SP1) dan yang lebih baru, Windows Vista, Windows Server 2008, dan versi sistem operasi berikutnya. Modul Kartu Pintar menyediakan fungsionalitas serupa.]

Metode ListCardInterfaces mengambil pengidentifikasi (GUID) dari semua antarmuka yang didukung untuk kartu pintar yang ditentukan.

Sintaks

HRESULT ListCardInterfaces(
  [in]  BSTR        bstrCardName,
  [out] LPSAFEARRAY *ppInterfaceGuids
);

Parameter

bstrCardName [in]

Nama kartu pintar.

ppInterfaceGuids [out]

Arahkan ke GUID antarmuka jika berhasil; NULL jika operasi gagal.

Nilai kembali

Metode mengembalikan salah satu nilai yang mungkin berikut ini.

Menampilkan kode	Deskripsi
S_OK	Operasi selesai dengan sukses.
E_INVALIDARG	Parameter tidak valid.
E_POINTER	Pointer buruk diteruskan di ppInterfaceGuids.
E_OUTOFMEMORY	Kehabisan memori.

 

Keterangan

Untuk mengambil penyedia layanan utama kartu pintar, panggil GetProviderCardId.

Untuk mengambil semua kartu pintar, pembaca, dan grup pembaca yang diketahui masing-masing memanggil ListCards, ListReaders, dan ListReaderGroups .

Untuk daftar semua metode yang disediakan oleh antarmuka ini, lihat ISCardDatabase.

Selain kode kesalahan COM yang tercantum di atas, antarmuka ini dapat mengembalikan kode kesalahan kartu pintar jika fungsi kartu pintar dipanggil untuk menyelesaikan permintaan. Untuk informasi selengkapnya, lihat Nilai Pengembalian Kartu Pintar.

Contoh

Contoh berikut menunjukkan pengambilan pengidentifikasi antarmuka yang didukung untuk kartu pintar yang ditentukan.

BSTR         bstrCard = NULL;
LPSAFEARRAY  pGuids = NULL;
HRESULT      hr;

bstrCard = SysAllocString(L"GemSAFE");
// Call the function for the specified card.
hr = pISCDataBase->ListCardInterfaces(bstrCard,
                                      &pGuids);
if (FAILED(hr))
{
   printf("Failed ListCardInterfaces\n");
   // Take other error handling action as needed.
}
else
{
   // Use the safe array as needed.
   // ...
   // Free BSTR when done.
   if (bstrCard)
       SysFreeString(bstrCard);
}

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Akhir dukungan klien	Windows XP
Akhir dukungan server	Windows Server 2003
Header	Scardmgr.h
Pustaka jenis	Scardmgr.tlb
DLL	Scardssp.dll
IID	IID_ISCardDatabase didefinisikan sebagai 1461AAC8-6810-11D0-918F-00AA00C18068

Lihat juga

GetProviderCardId

ISCardDatabase

Kartu Daftar

ListReaderGroups

ListReaders