Fungsi SCardGetProviderIdA (winscard.h)

Artikel
2024-11-20

Fungsi SCardGetProviderId mengembalikan pengidentifikasi (GUID) penyedia layanan utama untuk kartu tertentu.

Pemanggil menyediakan nama kartu pintar (sebelumnya diperkenalkan ke sistem) dan menerima pengidentifikasi terdaftar dari GUID penyedia layanan utama, jika ada.

Sintaksis

LONG SCardGetProviderIdA(
  [in]  SCARDCONTEXT hContext,
  [in]  LPCSTR       szCard,
  [out] LPGUID       pguidProviderId
);

Parameter

[in] hContext

Tangani yang mengidentifikasi konteks resource manager untuk kueri. Konteks resource manager dapat diatur oleh panggilan sebelumnya ke SCardEstablishContext. Parameter ini tidak dapat null.

[in] szCard

Nama kartu yang ditentukan ke sistem.

[out] pguidProviderId

Pengidentifikasi (GUID) penyedia layanan utama. Penyedia ini dapat diaktifkan menggunakan COM, dan akan menyediakan akses ke layanan lain dalam kartu.

Mengembalikan nilai

Fungsi ini mengembalikan nilai yang berbeda tergantung pada apakah berhasil atau gagal.

Mengembalikan kode	Deskripsi
Keberhasilan	SCARD_S_SUCCESS.
Kegagalan	Kode kesalahan. Untuk informasi selengkapnya, lihat Nilai Pengembalian Kartu Pintar.

Komentar

Fungsi ini tidak dialihkan, tetapi memanggil fungsi ketika berada di dalam sesi Desktop Jauh tidak akan mengakibatkan kesalahan. Ini hanya berarti bahwa hasilnya akan berasal dari komputer jarak jauh alih-alih komputer lokal.

Fungsi SCardGetProviderId adalah fungsi kueri database. Untuk informasi selengkapnya tentang fungsi kueri database lainnya, lihat Fungsi Kueri Database Kartu Pintar.

Contoh

Contoh berikut menunjukkan cara mendapatkan ID penyedia untuk kartu yang ditentukan. Contoh mengasumsikan bahwa hContext adalah handel valid yang diperoleh dari panggilan sebelumnya ke fungsi SCardEstablishContext dan bahwa "MyCardName" diperkenalkan oleh panggilan sebelumnya ke fungsi SCardIntroduceCardType.

GUID    guidProv;
LONG    lReturn;

lReturn = SCardGetProviderId(hContext, 
                             L"MyCardName",
                             &guidProv);
if ( SCARD_S_SUCCESS != lReturn )
    printf("Failed SCardGetProviderId - %x\n", lReturn);
else
{
    // Use the provider GUID as needed.
    // ...
}

Nota

Header winscard.h mendefinisikan SCardGetProviderId sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosedur UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

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

Lihat juga

SCardEstablishContext

SCardListCards

SCardListInterfaces

SCardListReaderGroups

SCardListReaders

Bagikan melalui