SCardIsValidContext 関数 (winscard.h)
SCardIsValidContext 関数は、スマート カード コンテキスト ハンドルが有効かどうかを判断します。
構文
LONG SCardIsValidContext(
[in] SCARDCONTEXT hContext
);
パラメーター
[in] hContext
リソース マネージャー コンテキストを識別するハンドル。 リソース マネージャー コンテキストは、 SCardEstablishContext の以前の呼び出しによって設定できます。
戻り値
この関数は、次のいずれかの値を返します。
リターン コード | 説明 |
---|---|
|
hContext パラメーターは有効です。 |
|
hContext パラメーターが無効です。 |
|
エラー コード。 詳細については、「 スマート カードの戻り値」を参照してください。 |
注釈
スマート カード コンテキスト ハンドルがまだ有効かどうかを判断するには、この関数を呼び出します。 スマート カード コンテキスト ハンドルが SCardEstablishContext によって設定された後、リソース マネージャー サービスがシャットダウンされると無効になることがあります。
例
次の例は、スマート カード コンテキスト ハンドルが有効かどうかを判断する方法を示しています。
// Check the smart card context handle.
// hContext was set previously by SCardEstablishContext.
LONG lReturn;
lReturn = SCardIsValidContext(hContext);
if ( SCARD_S_SUCCESS != lReturn )
{
// Function failed; check return value.
if ( ERROR_INVALID_HANDLE == lReturn )
printf("Handle is invalid\n");
else
{
// Some unexpected error occurred; report and bail out.
printf("Failed SCardIsValidContext - %x\n", lReturn);
exit(1); // Or other appropriate error action.
}
}
else
{
// Handle is valid; proceed as needed.
// ...
}
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
対象プラットフォーム | Windows |
ヘッダー | winscard.h |
Library | Winscard.lib |
[DLL] | Winscard.dll |