SCardWriteCache function
The SCardWriteCache function writes a name-value pair from a smart card to the global cache maintained by the Smart Card Resource Manager.
Syntax
LONG WINAPI SCardWriteCache( _In_ SCARDCONTEXT hContext, _In_ UUID *CardIdentifier, _In_ DWORD FreshnessCounter, _In_ LPTSTR LookupName, _In_ PBYTE Data, _In_ DWORD DataLen );
Parameters
- hContext [in]
-
A handle that identifies the resource manager context. The resource manager context is set by a previous call to SCardEstablishContext.
- CardIdentifier [in]
-
A pointer to a value that uniquely identifies the smart card from which the name-value pair was read.
- FreshnessCounter [in]
-
The current revision of the cached data.
- LookupName [in]
-
A pointer to a null-terminated string that contains the name portion of the name-value pair to write to the global cache.
- Data [in]
-
A pointer to an array of byte values that contain the value portion of the name-value pair to write to the global cache.
- DataLen [in]
-
The size, in bytes, of the Data buffer.
Return value
If the function succeeds, it returns SCARD_S_SUCCESS.
If the function fails, it returns one of the following error codes. For more information, see Smart Card Return Values.
| Return code/value | Description |
|---|---|
|
The size of the specified name-value pair exceeds the maximum size defined for the global cache. |
Requirements
|
Minimum supported client |
Windows Vista [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows Server 2008 [desktop apps only] |
|
Header |
|
|
Library |
|
|
DLL |
|
|
Unicode and ANSI names |
SCardWriteCacheW (Unicode) and SCardWriteCacheA (ANSI) |
See also