Metode ISCard::get_Context

[Metode get_Context 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 get_Context mengambil handel konteks manajer sumber daya saat ini. Metode ini mengembalikan (*pContext) == NULL jika tidak ada konteks yang ditetapkan.

Sintaks

HRESULT get_Context(
  [out] HSCARDCONTEXT *pContext
);

Parameter

pContext [out]

Arahkan ke handel konteks saat dikembalikan.

Nilai kembali

Metode mengembalikan salah satu nilai yang mungkin berikut ini.

Menampilkan kode	Deskripsi
S_OK	Operasi selesai dengan sukses.
E_INVALIDARG	Parameter pContext tidak valid.
E_POINTER	Pointer buruk diteruskan dalam pContext.

 

Keterangan

Konteks resource manager diatur dengan memanggil fungsi kartu pintarSCardEstablishContext.

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 handel konteks resource manager saat ini.

HSCARDCONTEXT  hCtx;
HRESULT        hr;

// Retrieve the smart card context.
hr = pISCard->get_Context(&hCtx);
if (FAILED(hr))
{
   printf("Failed get_Context\n");
   // Take other error handling action as needed.
}
// Use smart card context as needed.

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_ISCard didefinisikan sebagai 1461AAC3-6810-11D0-918F-00AA00C18068

Lihat juga

get_Atr

get_CardHandle

get_Protocol

get_Status

ISCard

SCardEstablishContext