SCardWriteCacheA 関数 (winscard.h)
SCardWriteCache 関数は、スマート カードから、スマート カード Resource Managerによって管理されるグローバル キャッシュに名前と値のペアを書き込みます。
構文
LONG SCardWriteCacheA(
[in] SCARDCONTEXT hContext,
[in] UUID *CardIdentifier,
[in] DWORD FreshnessCounter,
[in] LPSTR LookupName,
[in] PBYTE Data,
[in] DWORD DataLen
);
パラメーター
[in] hContext
リソース マネージャー コンテキストを識別するハンドル。 リソース マネージャー コンテキストは、 SCardEstablishContext の以前の呼び出しによって設定されます。
[in] CardIdentifier
名前と値のペアが読み取られたスマート カードを一意に識別する値へのポインター。
[in] FreshnessCounter
キャッシュされたデータの現在のリビジョン。
[in] LookupName
グローバル キャッシュに書き込む名前と値のペアの名前部分を含む null で終わる文字列へのポインター。
[in] Data
グローバル キャッシュに書き込む名前と値のペアの値部分を含むバイト値の配列へのポインター。
[in] DataLen
データ バッファーのサイズ (バイト単位)。
戻り値
関数が成功すると、 SCARD_S_SUCCESSが返されます。
関数が失敗すると、次のいずれかのエラー コードが返されます。 詳細については、「 スマート カードの戻り値」を参照してください。
リターン コード/値 | Description |
---|---|
|
指定した名前と値のペアのサイズが、グローバル キャッシュに定義されている最大サイズを超えています。 |
解説
注意
winscard.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして SCardWriteCache を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | winscard.h |
Library | Winscard.lib |
[DLL] | Winscard.dll |