SCardIsValidContext-Funktion (winscard.h)

Artikel
08/27/2023

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
SCARD_S_SUCCESS	Der hContext-Parameter ist gültig.
ERROR_INVALID_HANDLE	Der hContext-Parameter ist ungültig.
Andere Werte	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

SCardEstablishContext

Freigeben über