UID | title | description | helpviewer_keywords | old-location | tech.root | ms.assetid | ms.date | ms.keywords | req.header | req.include-header | req.target-type | req.target-min-winverclnt | req.target-min-winversvr | req.kmdf-ver | req.umdf-ver | req.ddi-compliance | req.unicode-ansi | req.idl | req.max-support | req.namespace | req.assembly | req.type-library | req.lib | req.dll | req.irql | targetos | req.typenames | req.redist | ms.custom | f1_keywords | dev_langs | topic_type | api_type | api_location | api_name | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
NF:winscard.SCardWriteCacheW |
SCardWriteCacheW function (winscard.h) |
Writes a name-value pair from a smart card to the global cache maintained by the Smart Card Resource Manager. (Unicode) |
|
security\scardwritecache.htm |
security |
e982e297-6a78-41f4-a81c-d207a96f1dab |
12/05/2018 |
SCardWriteCache, SCardWriteCache function [Security], SCardWriteCacheA, SCardWriteCacheW, security.scardwritecache, winscard/SCardWriteCache, winscard/SCardWriteCacheA, winscard/SCardWriteCacheW |
winscard.h |
Windows |
Windows Vista [desktop apps only] |
Windows Server 2008 [desktop apps only] |
SCardWriteCacheW (Unicode) and SCardWriteCacheA (ANSI) |
Winscard.lib |
Winscard.dll |
Windows |
19H1 |
|
|
|
|
|
|
The SCardWriteCache function writes a name-value pair from a smart card to the global cache maintained by the Smart Card Resource Manager.
A handle that identifies the resource manager context. The resource manager context is set by a previous call to SCardEstablishContext.
A pointer to a value that uniquely identifies the smart card from which the name-value pair was read.
The current revision of the cached data.
A pointer to a null-terminated string that contains the name portion of the name-value pair to write to the global cache.
A pointer to an array of byte values that contain the value portion of the name-value pair to write to the global cache.
The size, in bytes, of the Data buffer.
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. |
Note
The winscard.h header defines SCardWriteCache as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.