SCardIsValidContext-Funktion (winscard.h)
Die SCardIsValidContext-Funktion bestimmt, ob ein smart Karte Kontexthandle gültig ist.
Syntax
LONG SCardIsValidContext(
[in] SCARDCONTEXT hContext
);
Parameter
[in] hContext
Handle, das den Ressourcen-Manager-Kontext identifiziert. Der Ressourcen-Manager-Kontext kann durch einen vorherigen Aufruf von SCardEstablishContext festgelegt werden.
Rückgabewert
Diese Funktion gibt einen der folgenden Werte zurück.
Rückgabecode | Beschreibung |
---|---|
|
Der hContext-Parameter ist gültig. |
|
Der hContext-Parameter ist ungültig. |
|
Ein Fehlercode. Weitere Informationen finden Sie unter Smartcard-Rückgabewerte. |
Hinweise
Rufen Sie diese Funktion auf, um zu bestimmen, ob ein Smart Karte Kontexthandle noch gültig ist. Nachdem ein Smart Karte Kontexthandle von SCardEstablishContext festgelegt wurde, wird es möglicherweise ungültig, wenn der Resource Manager-Dienst heruntergefahren wurde.
Beispiele
Das folgende Beispiel zeigt, ob ein smart Karte Kontexthandle gültig ist.
// 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.
// ...
}
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | winscard.h |
Bibliothek | Winscard.lib |
DLL | Winscard.dll |
Weitere Informationen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für