ISCard::AttachByReader 메서드

[ AttachByReader 메서드는 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. Windows Server 2003 SP1(서비스 팩 1) 이상, Windows Vista, Windows Server 2008 및 이후 버전의 운영 체제에서는 사용할 수 없습니다. 스마트 카드 모듈은 비슷한 기능을 제공합니다.]

AttachByReader 메서드는 명명된 판독기에서 스마트 카드 엽니다.

구문

HRESULT AttachByReader(
  [in] BSTR              bstrReaderName,
  [in] SCARD_SHARE_MODES ShareMode,
  [in] SCARD_PROTOCOLS   PrefProtocol
);

매개 변수

bstrReaderName [in]

스마트 카드 판독기의 이름을 포함하는 BSTR입니다.

ShareMode [in]

스마트 카드 대한 액세스를 요청할 모드입니다.

값	의미
독점	다른 누구도 스마트 카드 이 연결을 사용하지 않습니다.
공유	다른 애플리케이션은 이 연결을 사용할 수 있습니다.

 

PrefProtocol [in]

기본 설정 프로토콜 값입니다.

T0

T1

RAW

T0| T1

반환 값

메서드는 다음 가능한 값 중 하나를 반환합니다.

반환 코드	Description
S_OK	명명된 판독기에서 스마트 카드 열기가 성공적으로 완료되었습니다.
E_INVALIDARG	함수에 전달된 하나 이상의 매개 변수에 문제가 있습니다.

 

설명

위에 나열된 COM 오류 코드 외에도 스마트 카드 함수를 호출하여 요청을 완료한 경우 이 인터페이스는 스마트 카드 오류 코드를 반환할 수 있습니다. 자세한 내용은 스마트 카드 반환 값을 참조하세요.

판독기 사용을 마쳤으면 ISCard::D etach 메서드를 호출하여 첨부 파일을 해제합니다.

예제

다음 예제에서는 지정된 스마트 카드 판독기에서 스마트 카드 연결하는 방법을 보여줍니다.

#include <windows.h>
#include <stdio.h>
#include <Scardmgr.h>

// The reader name is vendor specific; change as needed.
#define READER_NAME L"Vendor Reader 0"

void main()
{
    BSTR     bstrReader = NULL;
    HRESULT  hr;

    bstrReader = SysAllocString(READER_NAME);
    if (NULL == bstrReader)
    {
        // Error encountered.
        exit(1);
    }

    // Connect to the reader.
    hr = pISCard->AttachByReader(bstrReader, SHARED, T0);
    if (FAILED(hr))
    {
        printf("Failed AttachByReader\n");
        // Take other error handling action.
        // ...
    }

    // Detach reader by calling ISCard::Detach (not shown).
    // ...

    // When done, free BSTR.
    if (NULL != bstrReader)
        SysFreeString(bstrReader);
}

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
클라이언트 지원 종료	Windows XP
서버 지원 종료	Windows Server 2003
헤더	Scardmgr.h
유형 라이브러리	Scardmgr.tlb
DLL	Scardssp.dll
IID	IID_ISCard 1461AAC3-6810-11D0-918F-00AA00C18068로 정의됩니다.

추가 정보

AttachByHandle

분리

ISCard

다시