다음을 통해 공유

ISCardFileAccess::GetFileCapabilities 메서드

  • 아티클

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

GetFileCapabilities 메서드는 현재 파일에서 파일 기능 목록을 검색합니다.

구문

HRESULT GetFileCapabilities(
  [in, out] LPTLV_TABLE *ppProperties,
  [in, out] LONG        *plProperties,
  [in]      SCARD_FLAGS Flags
);

매개 변수

ppProperties [in, out]

TLV(태그, 길이, 값) 구조체에 대한 포인터입니다. 입력에서 이 매개 변수는 속성을 가져올 파일을 나타냅니다. 출력에서 이 매개 변수에는 속성이 포함됩니다. 다음 예제는 TLV 구조체의 정의입니다.

#include <windows.h>

typedef struct
{
  DWORD  Tag;
  DWORD  Length;
  BYTE[]  Value;
  BOOL  Valid;
} TLV;

TLV 구조에 대한 자세한 내용은 를 참조하세요 https://pcscworkgroup.com/.

plProperties [in, out]

ppProperties의 TLV 항목 수에 대한 포인터입니다.

Flags [in]

보안 메시징을 사용하고 데이터를 미리 할당해야 하는지 여부를 지정합니다.

SC_FL_SECURE_MESSAGING

SC_FL_PREALLOCATED

반환 값

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

반환 코드 설명
S_OK
 작업이 성공적으로 완료되었습니다.
E_INVALIDARG
 잘못된 매개 변수입니다.
E_POINTER
 잘못된 포인터가 전달되었습니다.
E_OUTOFMEMORY
 메모리가 부족합니다.

 

설명

이 인터페이스에서 정의한 모든 메서드 목록은 ISCardFileAccess를 참조하세요.

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

요구 사항

요구 사항 값
지원되는 최소 클라이언트
 Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버
 Windows Server 2003 [데스크톱 앱만 해당]
클라이언트 지원 종료
 Windows XP
서버 지원 종료
 Windows Server 2003

추가 정보

ISCardFileAccess