ISCardFileAccess::GetFileCapabilities メソッド
[ GetFileCapabilities メソッドは、[要件] セクションで指定されたオペレーティング システムで使用できます。 Windows Server 2003 Service Pack 1 (SP1) 以降、Windows Vista、Windows Server 2008、および以降のバージョンのオペレーティング システムでは使用できません。 スマート カード モジュールも同様の機能を提供します。
GetFileCapabilities メソッドは、現在のファイルからファイル機能の一覧を取得します。
構文
HRESULT GetFileCapabilities(
[in, out] LPTLV_TABLE *ppProperties,
[in, out] LONG *plProperties,
[in] SCARD_FLAGS Flags
);
パラメーター
-
ppProperties [in, out]
-
TLV (タグ、長さ、値) 構造体へのポインター。 入力時に、このパラメーターはプロパティを取得するファイルを示します。出力時に、このパラメーターには プロパティが含まれます。 次の例は、TLV 構造体の定義です。
#include <windows.h> typedef struct { DWORD Tag; DWORD Length; BYTE[] Value; BOOL Valid; } TLV;
TLV 構造体の詳細については、「」を参照してください https://pcscworkgroup.com/。
-
plProperties [in, out]
-
ppProperties 内の TLV エントリの数へのポインター。
-
Flags [in]
-
セキュリティで保護されたメッセージングを使用し、データを事前割り当てする必要があるかどうかを指定します。
-
SC_FL_SECURE_MESSAGING
-
SC_FL_PREALLOCATED
-
戻り値
メソッドは、次のいずれかの値を返します。
リターン コード | 説明 |
---|---|
|
操作が正常に完了しました。 |
|
無効なパラメーター。 |
|
不適切なポインターが渡されました。 |
|
メモリが不足しています。 |
解説
このインターフェイスで定義されているすべてのメソッドの一覧については、「 ISCardFileAccess」を参照してください。
上記の COM エラー コードに加えて、要求を完了するためにスマート カード関数が呼び出された場合、このインターフェイスはスマート カード エラー コードを返す場合があります。 詳細については、「 スマート カードの戻り値」を参照してください。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント |
Windows XP [デスクトップ アプリのみ] |
サポートされている最小のサーバー |
Windows Server 2003 [デスクトップ アプリのみ] |
クライアント サポートの終了 |
Windows XP |
サーバー サポートの終了 |
Windows Server 2003 |
関連項目