SCardIsValidContext 함수(winscard.h)

SCardIsValidContext 함수는 스마트 카드 컨텍스트 핸들이 유효한지 여부를 결정합니다.

구문

LONG SCardIsValidContext(
  [in] SCARDCONTEXT hContext
);

매개 변수

[in] hContext

리소스 관리자 컨텍스트를 식별하는 핸들입니다. 리소스 관리자 컨텍스트는 SCardEstablishContext에 대한 이전 호출을 통해 설정할 수 있습니다.

반환 값

이 함수는 다음 값 중 하나를 반환합니다.

반환 코드	설명
SCARD_S_SUCCESS	hContext 매개 변수가 유효합니다.
ERROR_INVALID_HANDLE	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
라이브러리	Winscard.lib
DLL	Winscard.dll

추가 정보

SCardEstablishContext