SCardRemoveReaderFromGroup function
The SCardRemoveReaderFromGroup function removes a reader from an existing reader group. This function has no effect on the reader.
Syntax
LONG WINAPI SCardRemoveReaderFromGroup( _In_ SCARDCONTEXT hContext, _In_ LPCTSTR szReaderName, _In_ LPCTSTR szGroupName );
Parameters
- hContext [in]
-
Handle that identifies the resource manager context. The resource manager context is set by a previous call to SCardEstablishContext. This parameter cannot be NULL.
- szReaderName [in]
-
Display name of the reader to be removed.
- szGroupName [in]
-
Display name of the group from which the reader should be removed.
Return value
This function returns different values depending on whether it succeeds or fails.
| Return code | Description |
|---|---|
|
SCARD_S_SUCCESS. |
|
An error code. For more information, see Smart Card Return Values. |
Remarks
When the last reader is removed from a group, the group is automatically forgotten.
The SCardRemoveReaderFromGroup function is a database management function. For information about other database management functions, see Smart Card Database Management Functions.
To add a reader to a reader group, use SCardAddReaderToGroup.
Examples
The following example shows how to remove a reader from the group.
// Remove a reader from the group. // lReturn is of type LONG. // hContext was set by a previous call to SCardEstablishContext. // The group is automatically forgotten if no readers remain in it. lReturn = SCardRemoveReaderFromGroup(hContext, L"MyReader", L"MyReaderGroup"); if ( SCARD_S_SUCCESS != lReturn ) printf("Failed SCardRemoveReaderFromGroup\n");
Requirements
|
Minimum supported client |
Windows XP [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows Server 2003 [desktop apps only] |
|
Header |
|
|
Library |
|
|
DLL |
|
|
Unicode and ANSI names |
SCardRemoveReaderFromGroupW (Unicode) and SCardRemoveReaderFromGroupA (ANSI) |
See also
- SCardEstablishContext
- SCardAddReaderToGroup
- SCardForgetCardType
- SCardForgetReader
- SCardForgetReaderGroup