ISCardLocate::FindCard 메서드

  • 아티클

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

FindCard 메서드는 스마트 카드 검색하여 유효한 연결을 엽니다.

구문

HRESULT FindCard(
  [in]  SCARD_SHARE_MODES ShareMode,
  [in]  SCARD_PROTOCOLS   Protocols,
  [in]  LONG              lFlags,
  [out] LPSCARDINFO       *ppCardInfo
);

매개 변수

ShareMode [in]

연결이 열릴 때 스마트 카드 공유하거나 공유하지 않는 모드입니다.

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

 

프로토콜 [in]

카드 연결할 때 사용할 프로토콜입니다.

T0

T1

RAW

T0| T1

lFlags [in]

사용자 인터페이스가 표시되는 시기를 지정합니다.

값 의미
SC_DLG_MINIMAL_UI
 호출하는 애플리케이션에서 검색하는 카드 위치하지 않고 판독기에서 사용할 수 있는 경우에만 대화 상자를 표시합니다. 이렇게 하면 카드 찾아서 연결하고(내부 대화 상자 메커니즘을 통해 또는 사용자 콜백 함수를 사용하여) 호출 애플리케이션에 반환할 수 있습니다.
SC_DLG_NO_UI
 검색 결과에 관계없이 UI 표시를 발생하지 않습니다.
SC_DLG_FORCE_UI
 검색 결과에 관계없이 UI 표시를 발생합니다.

 

ppCardInfo [out]

성공한 경우 열린 스마트 카드 대한 정보를 포함하거나 반환하는 데이터 구조에 대한 포인터에 대한 포인터입니다. 작업이 실패한 경우 NULL 이 됩니다.

반환 값

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

반환 코드 Description
S_OK
 작업이 완료되었습니다.
E_INVALIDARG
 잘못된 매개 변수입니다.
E_POINTER
 잘못된 포인터가 ppCardInfo에 전달되었습니다.
E_OUTOFMEMORY
 메모리가 부족합니다.

 

설명

검색의 검색 조건을 설정하려면 ConfigureCardNameSearch를 호출하여 스마트 카드 카드 이름을 지정합니다.

이 인터페이스에서 제공하는 모든 메서드 목록은 ISCardLocate를 참조하세요.

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

요구 사항

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

추가 정보

ConfigureCardNameSearch

ISCardLocate