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

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

Синтаксис

LONG SCardIsValidContext(
  [in] SCARDCONTEXT hContext
);

Параметры

[in] hContext

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

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

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

Комментарии

Вызовите эту функцию, чтобы определить, действителен ли дескриптор контекста интеллектуального карта. После того как 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.
    // ...
}

Требования

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

SCardEstablishContext