Функция SCardIsValidContext (winscard.h)

Статья
03/13/2024

Функция SCardIsValidContext определяет, является ли дескриптор контекста смарт-карта допустимым.

Синтаксис

LONG SCardIsValidContext(
  [in] SCARDCONTEXT hContext
);

Параметры

[in] hContext

Дескриптор, идентифицирующий контекст Resource Manager. Контекст диспетчера ресурсов можно задать с помощью предыдущего вызова SCardEstablishContext.

Возвращаемое значение

Эта функция возвращает одно из следующих значений.

Код возврата	Описание
SCARD_S_SUCCESS	Допустимый параметр hContext .
ERROR_INVALID_HANDLE	Недопустимый параметр hContext .
Другие значения	Код ошибки. Дополнительные сведения см. в разделе Возвращаемые значения смарт-карты.

Вызовите эту функцию, чтобы определить, действителен ли дескриптор контекста интеллектуального карта. После того как SCardEstablishContext задал дескриптор контекста интеллектуального карта, он может стать недействительным, если служба Resource Manager была завершена.

Примеры

В следующем примере показано, является ли допустимым дескриптор контекста интеллектуального карта.

// 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
Header	winscard.h
Библиотека	Winscard.lib
DLL	Winscard.dll

См. также раздел

SCardEstablishContext