次の方法で共有

SCardReadCacheA 関数 (winscard.h)

  • [アーティクル]

SCardReadCache 関数は、スマート カード リソース マネージャーによって維持されるグローバル キャッシュから、名前と値のペアの値部分を取得します。

構文

LONG SCardReadCacheA(
  [in]  SCARDCONTEXT hContext,
  [in]  UUID         *CardIdentifier,
  [in]  DWORD        FreshnessCounter,
  [in]  LPSTR        LookupName,
  [out] PBYTE        Data,
  [out] DWORD        *DataLen
);

パラメーター

[in] hContext

リソース マネージャー コンテキストを識別するハンドル。 リソース マネージャー コンテキストは、SCardEstablishContextを する以前の呼び出しによって設定されます。

[in] CardIdentifier

スマート カードを一意に識別する値へのポインター。 この関数がグローバル キャッシュから読み取る名前と値のペアは、このスマート カードに関連付けられています。

[in] FreshnessCounter

キャッシュされたデータの現在のリビジョン。

[in] LookupName

値部分を取得する名前と値のペアの名前部分を含む null で終わる文字列へのポインター。

[out] Data

LookupName パラメーターで指定された名前と値のペアの値部分を含むバイト値の配列へのポインター。

[out] DataLen

Data バッファーのサイズ (バイト単位) へのポインター。

戻り値

関数が成功した場合は、SCARD_S_SUCCESSを返します。

関数が失敗すると、次のいずれかのエラー コードが返されます。 詳細については、「スマート カードの戻り値 を参照してください。

戻りコード/値 形容
SCARD_W_CACHE_ITEM_NOT_FOUND
0x80100070
 指定した名前と値のペアがグローバル キャッシュに見つかりませんでした。
SCARD_W_CACHE_ITEM_STALE
0x80100071
 指定された名前と値のペアが要求されたよりも古く、キャッシュから削除されました。

備考

手記

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

必要条件

要件 価値
サポートされる最小クライアント Windows Vista [デスクトップ アプリのみ]
サポートされる最小サーバー Windows Server 2008 [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー winscard.h
ライブラリ Winscard.lib
DLL Winscard.dll

関連項目

SCardWriteCache の