Share via

SCardReconnect 함수(winscard.h)

  • 아티클

SCardReconnect 함수는 호출하는 애플리케이션과 스마트 카드 간의 기존 연결을 다시 설정합니다. 이 함수는 카드 핸들을 직접 액세스에서 일반 액세스로 이동하거나 카드 대한 추가 액세스를 방지하는 오류 조건을 승인하고 지웁니다.

구문

LONG SCardReconnect(
  [in]            SCARDHANDLE hCard,
  [in]            DWORD       dwShareMode,
  [in]            DWORD       dwPreferredProtocols,
  [in]            DWORD       dwInitialization,
  [out, optional] LPDWORD     pdwActiveProtocol
);

매개 변수

[in] hCard

SCardConnect에 대한 이전 호출에서 가져온 참조 값입니다.

[in] dwShareMode

다른 애플리케이션이 이 카드 대한 연결을 형성할 수 있는지 여부를 나타내는 플래그입니다.

값 의미
SCARD_SHARE_SHARED
 이 애플리케이션은 이 카드 다른 애플리케이션과 공유합니다.
SCARD_SHARE_EXCLUSIVE
 이 애플리케이션은 이 카드 다른 애플리케이션과 공유하지 않습니다.

[in] dwPreferredProtocols

이 연결에 허용되는 프로토콜의 비트 마스크입니다. 가능한 값은 OR 연산과 결합될 수 있습니다.

이 매개 변수의 값에는 현재 프로토콜이 포함되어야 합니다. 현재 프로토콜 이외의 프로토콜과 다시 연결하려고 하면 오류가 발생합니다.

값 의미
SCARD_PROTOCOL_T0
 T=0 은 허용되는 프로토콜입니다.
SCARD_PROTOCOL_T1
 T=1 은 허용되는 프로토콜입니다.

[in] dwInitialization

카드 수행해야 하는 초기화 유형입니다.

값 의미
SCARD_LEAVE_CARD
 다시 연결에는 특별한 작업을 수행하지 마세요.
SCARD_RESET_CARD
 카드 다시 설정합니다(웜 재설정).
SCARD_UNPOWER_CARD
 카드 전원을 낮추고 초기화합니다(콜드 재설정).

[out, optional] pdwActiveProtocol

설정된 활성 프로토콜을 나타내는 플래그입니다.

값 의미
SCARD_PROTOCOL_T0
 T=0 은 활성 프로토콜입니다.
SCARD_PROTOCOL_T1
 T=1 은 활성 프로토콜입니다.

반환 값

이 함수는 성공 또는 실패 여부에 따라 다른 값을 반환합니다.

반환 코드 설명
Success
 SCARD_S_SUCCESS.
실패
 오류 코드입니다. 자세한 내용은 스마트 카드 반환 값을 참조하세요.

설명

SCardReconnect는 스마트 카드 및 판독기 액세스 함수입니다. 다른 액세스 함수에 대한 자세한 내용은 스마트 카드 및 판독기 액세스 함수를 참조하세요.

예제

다음 예제에서는 연결을 다시 설정합니다.

DWORD     dwAP;
LONG      lReturn;

// Reconnect.
// hCardHandle was set by a previous call to SCardConnect.
lReturn = SCardReconnect(hCardHandle,
                         SCARD_SHARE_SHARED,
                         SCARD_PROTOCOL_T0 | SCARD_PROTOCOL_T1,
                         SCARD_LEAVE_CARD,
                         &dwAP );
if ( SCARD_S_SUCCESS != lReturn )
    printf("Failed SCardReconnect\n");

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 winscard.h
라이브러리 Winscard.lib
DLL Winscard.dll

추가 정보

SCardConnect

SCardDisconnect