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
SCARD_W_CACHE_ITEM_TOO_BIG 0x80100072	指定した名前と値のペアのサイズが、グローバル キャッシュに定義されている最大サイズを超えています。

解説

注意

winscard.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして SCardWriteCache を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	winscard.h
Library	Winscard.lib
[DLL]	Winscard.dll

関連項目

SCardReadCache