SCardStatusA 함수(winscard.h)

SCardStatus 함수는 판독기스마트 카드 현재 상태를 제공합니다. SCardConnect 성공적으로 호출한 후 SCardDisconnect성공적으로 호출하기 전에 언제든지 호출할 수 있습니다. 판독기 또는 판독기 드라이버상태 영향을 주지 않습니다.

통사론

LONG SCardStatusA(
  [in]                SCARDHANDLE hCard,
  [out]               LPSTR       mszReaderNames,
  [in, out, optional] LPDWORD     pcchReaderLen,
  [out, optional]     LPDWORD     pdwState,
  [out, optional]     LPDWORD     pdwProtocol,
  [out]               LPBYTE      pbAtr,
  [in, out, optional] LPDWORD     pcbAtrLen
);

매개 변수

[in] hCard

SCardConnect반환된 참조 값입니다.

[out] mszReaderNames

현재 연결된 판독기를 알 수 있는 표시 이름(여러 문자열) 목록입니다.

[in, out, optional] pcchReaderLen

입력 시 szReaderName 버퍼의 길이를 제공합니다.

출력 시 후행 NULL 문자를 포함하여 판독기 이름 목록의 실제 길이(문자)를 받습니다. 이 버퍼 길이가 SCARD_AUTOALLOCATE 지정된 경우 szReaderName 바이트 포인터에 대한 포인터로 변환되고 다중 문자열 구조가 포함된 메모리 블록의 주소를 받습니다.

[out, optional] pdwState

판독기에서 스마트 카드의 현재 상태. 성공하면 다음 상태 표시기 중 하나를 받습니다.

[out, optional] pdwProtocol

현재 프로토콜(있는 경우)입니다. 반환된 값은 pdwState 반환된 값이 SCARD_SPECIFICMODE 경우에만 의미가 있습니다.

[out] pbAtr

사용 가능한 경우 현재 삽입된 카드에서 ATR 문자열 받는 32 바이트 버퍼에 대한 포인터입니다.

[in, out, optional] pcbAtrLen

입력에서 pbAtr 버퍼의 길이를 제공합니다. 출력 시 ATR 문자열의 바이트 수(최대 32바이트)를 받습니다. 이 버퍼 길이가 SCARD_AUTOALLOCATE 지정된 경우 pbAtr 바이트 포인터에 대한 포인터로 변환되고 다중 문자열 구조가 포함된 메모리 블록의 주소를 받습니다.

반환 값

함수가 판독기스마트 카드 현재 상태를 성공적으로 제공하면 반환 값이 SCARD_S_SUCCESS.

함수가 실패하면 오류 코드가 반환됩니다. 자세한 내용은 스마트 카드 반환 값참조하세요.

발언

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

예제

다음 예제에서는 스마트 카드의 상태를 확인하는 방법을 보여줍니다.

WCHAR           szReader[200];
DWORD           cch = 200;
BYTE            bAttr[32];
DWORD           cByte = 32;
DWORD           dwState, dwProtocol;
LONG            lReturn;

// Determine the status.
// hCardHandle was set by an earlier call to SCardConnect.
lReturn = SCardStatus(hCardHandle,
                      szReader,
                      &cch,
                      &dwState,
                      &dwProtocol,
                      (LPBYTE)&bAttr,
                      &cByte); 

if ( SCARD_S_SUCCESS != lReturn )
{
    printf("Failed SCardStatus\n");
    exit(1);     // or other appropriate action
}

// Examine retrieved status elements.
// Look at the reader name and card state.
printf("%S\n", szReader );
switch ( dwState )
{
    case SCARD_ABSENT:
        printf("Card absent.\n");
        break;
    case SCARD_PRESENT:
        printf("Card present.\n");
        break;
    case SCARD_SWALLOWED:
        printf("Card swallowed.\n");
        break;
    case SCARD_POWERED:
        printf("Card has power.\n");
        break;
    case SCARD_NEGOTIABLE:
        printf("Card reset and waiting PTS negotiation.\n");
        break;
    case SCARD_SPECIFIC:
        printf("Card has specific communication protocols set.\n");
        break;
    default:
        printf("Unknown or unexpected card state.\n");
        break;
}

요구 사항

참고 항목

SCardConnect

SCardDisconnect