SCardWriteCacheA 関数 (winscard.h)
SCardWriteCache 関数は、スマート カードから、スマート カード リソース マネージャーによって維持されるグローバル キャッシュに名前と値のペアを書き込みます。
構文
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
Data バッファーのサイズ (バイト単位)。
戻り値
関数が成功した場合は、SCARD_S_SUCCESSを返します。
関数が失敗すると、次のいずれかのエラー コードが返されます。 詳細については、「スマート カードの戻り値 を参照してください。
戻りコード/値 | 形容 |
---|---|
|
指定した名前と値のペアのサイズが、グローバル キャッシュに定義されている最大サイズを超えています。 |
備考
手記
winscard.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして SCardWriteCache を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
要件 | 価値 |
---|---|
サポートされる最小クライアント | Windows Vista [デスクトップ アプリのみ] |
サポートされる最小サーバー | Windows Server 2008 [デスクトップ アプリのみ] |
ターゲット プラットフォーム の |
ウィンドウズ |
ヘッダー | winscard.h |
ライブラリ | Winscard.lib |
DLL | Winscard.dll |
関連項目
SCardReadCache の