ISCard::ReAttach method
[The ReAttach 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 ReAttach method resets, or reinitializes, the smart card.
Syntax
HRESULT ReAttach(
[in] SCARD_SHARE_MODES ShareMode,
[in] SCARD_DISPOSITIONS InitState
);
Parameters
-
ShareMode [in]
-
Mode in which to share or exclusively own the connection to the smart card.
Value Meaning - EXCLUSIVE
No one else use this connection to the smart card. - SHARED
Other applications can use this connection. -
InitState [in]
-
Indicates what to do with the card.
Value Meaning - LEAVE
Leaves the smart card in the current state. - RESET
Resets the smart card to some known state. - UNPOWER
Removes power from the smart card. - EJECT
Ejects the smart card if the reader has eject capabilities.
Return value
The method returns one of the following possible values.
| Return code | Description |
|---|---|
|
Operation completed successfully. |
|
There is something wrong with one or more of the parameters passed into the function. |
Remarks
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 reinitializing the smart card.
HRESULT hr;
// Reattach the smart card.
hr = pISCard->ReAttach(SHARED, LEAVE);
if (FAILED(hr))
{
printf("Failed ReAttach\n");
// Take error handling action 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