ISCard::get_Context method
[The get_Context method is available for use in the operating systems specified in the Requirements section. It is not available for use in Windows Server 2003 with Service Pack 1 (SP1) and later, Windows Vista, Windows Server 2008, and subsequent versions of the operating system. The Smart Card Modules provide similar functionality.]
The get_Context method retrieves the current resource manager context handle. This method returns (*pContext) == NULL if no context has been established.
Syntax
HRESULT get_Context(
[out] HSCARDCONTEXT *pContext
);
Parameters
-
pContext [out]
-
Pointer to the context handle on return.
Return value
The method returns one of the following possible values.
| Return code | Description |
|---|---|
|
Operation completed successfully. |
|
The pContext parameter is not valid. |
|
A bad pointer was passed in pContext. |
Remarks
The resource manager context is set by calling the smart card function SCardEstablishContext.
In addition to the COM error codes listed above, this interface may return a smart card error code if a smart card function was called to complete the request. For more information, see Smart Card Return Values.
Examples
The following example shows retrieving the current resource manager context handle.
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.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client |
Windows XP [desktop apps only] |
| Minimum supported server |
Windows Server 2003 [desktop apps only] |
| End of client support |
Windows XP |
| End of server support |
Windows Server 2003 |
| Header |
|
| Type library |
|
| DLL |
|
| IID |
IID_ISCard is defined as 1461AAC3-6810-11D0-918F-00AA00C18068 |
See also