[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 |
|---|---|
| S_OK | Operation completed successfully. |
| E_INVALIDARG | 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 | Scardmgr.h |
| Type library | Scardmgr.tlb |
| DLL | Scardssp.dll |
| IID | IID_ISCard is defined as 1461AAC3-6810-11D0-918F-00AA00C18068 |
See also
Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.
