SCardSetAttrib 함수(winscard.h)

SCardSetAttrib 함수는 지정된 핸들에 대해 지정된 판독기 특성을 설정합니다. 판독기, 판독기 드라이버 또는 스마트 카드상태에는 영향을 주지 않습니다. 대부분의 특성이 전송 프로토콜을 직접 제어하기 때문에 모든 판독기에서 모든 특성이 지원되는 것은 아닙니다(항상 설정할 수도 없음).

구문

LONG SCardSetAttrib(
  [in] SCARDHANDLE hCard,
  [in] DWORD       dwAttrId,
  [in] LPCBYTE     pbAttr,
  [in] DWORD       cbAttrLen
);

매개 변수

[in] hCard

SCardConnect에서 반환된 참조 값입니다.

[in] dwAttrId

설정할 특성의 식별자입니다. 값은 쓰기 전용입니다. 공급업체는 모든 특성을 지원하지 않을 수 있습니다.

값	의미
SCARD_ATTR_SUPRESS_T1_IFS_REQUEST	판독기에서 카드 T=1 IFSD 패킷을 보내지 않습니다. (현재 삽입된 카드 IFSD 요청을 지원하지 않는 경우 사용할 수 있습니다.)

[in] pbAttr

ID가 dwAttrId에 제공된 특성을 제공하는 버퍼에 대한 포인터입니다.

[in] cbAttrLen

pbAttr 버퍼의 특성 값 길이(바이트)입니다.

반환 값

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

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

설명

SCardSetAttrib 함수는 직접 카드 액세스 함수입니다. 다른 직접 액세스 함수에 대한 자세한 내용은 직접 카드 액세스 함수를 참조하세요.

예제

다음 예제에서는 특성을 설정하는 방법을 보여줍니다.

// Set the attribute.
// hCardHandle was set by a previous call to SCardConnect.
// dwAttrID is a DWORD value, specifying the attribute ID.
// pbAttr points to the buffer of the new value.
// cByte is the count of bytes in the buffer.
lReturn = SCardSetAttrib(hCardHandle,
                         dwAttrID,
                         (LPBYTE)pbAttr,
                         cByte);
if ( SCARD_S_SUCCESS != lReturn )
    printf("Failed SCardSetAttrib\n");

요구 사항

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

추가 정보

SCardConnect

SCardGetAttrib