Skip to content

Latest commit

 

History

History
116 lines (90 loc) · 3.72 KB

nf-winscard-scardwritecachew.md

File metadata and controls

116 lines (90 loc) · 3.72 KB
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)
SCardWriteCache
SCardWriteCache function [Security]
SCardWriteCacheW
security.scardwritecache
winscard/SCardWriteCache
winscard/SCardWriteCacheW
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
SCardWriteCacheW
winscard/SCardWriteCacheW
c++
APIRef
kbSyntax
DllExport
Winscard.dll
SCardWriteCache
SCardWriteCacheA
SCardWriteCacheW

SCardWriteCacheW function

-description

The SCardWriteCache function writes a name-value pair from a smart card to the global cache maintained by the Smart Card Resource Manager.

-parameters

-param hContext [in]

A handle that identifies the resource manager context. The resource manager context is set by a previous call to SCardEstablishContext.

-param CardIdentifier [in]

A pointer to a value that uniquely identifies the smart card from which the name-value pair was read.

-param FreshnessCounter [in]

The current revision of the cached data.

-param 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.

-param 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.

-param DataLen [in]

The size, in bytes, of the Data buffer.

-returns

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
SCARD_W_CACHE_ITEM_TOO_BIG
0x80100072
The size of the specified name-value pair exceeds the maximum size defined for the global cache.

-see-also

SCardReadCache

-remarks

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.