WINBIO_PROPERTY 상수

아티클
06/13/2023

다음 상수는WinBioGetProperty 함수의 PropertyId 매개 변수에서 쿼리할 속성을 지정하는 데 사용할 수 있는 WINBIO_PROPERTY_ID 값입니다. WinBioSetProperty 함수에서 동일한 매개 변수를 사용하여 일부 속성을 설정할 수도 있습니다. 쿼리 결과는 해당 함수의 PropertyBuffer 매개 변수에 반환되거나 지정되며, 결과의 형식과 크기는 쿼리되는 속성에 따라 달라집니다.

상수/값	설명
WINBIO_PROPERTY_SAMPLE_HINT 1	이 읽기 전용 생체 인식 속성은 등록 템플릿을 완료하는 데 필요한 양호한 생체 인식 샘플의 최대 수를 추정합니다. 속성 쿼리의 결과는 힌트를 포함하는 ULONG 값으로 반환됩니다. 이 속성을 쿼리할 때 전달된 SessionHandle 및 UnitId 매개 변수는 유효해야 하고 Identity 매개 변수는 NULL이어야 하며 SubFactor 매개 변수는 WINBIO_SUBTYPE_NO_INFORMATION 합니다.
WINBIO_PROPERTY_EXTENDED_SENSOR_INFO 2	이 읽기 전용 생체 인식 속성에는 특정 생체 인식 단위에 연결된 센서 구성 요소의 기능 및 특성에 대한 확장된 정보가 포함되어 있습니다. 속성 쿼리의 결과는 WINBIO_EXTENDED_SENSOR_INFO 구조체로 반환됩니다. 이 속성을 쿼리할 때 전달된 SessionHandle 및 UnitId 매개 변수는 유효해야 하고 Identity 매개 변수는 NULL이어야 하며 SubFactor 매개 변수는 WINBIO_SUBTYPE_NO_INFORMATION 합니다.
WINBIO_PROPERTY_EXTENDED_ENGINE_INFO 3	이 읽기 전용 생체 인식 속성에는 특정 생체 인식 단위에 연결된 엔진 구성 요소의 기능 및 특성에 대한 확장된 정보가 포함되어 있습니다. 속성 쿼리의 결과는 WINBIO_EXTENDED_ENGINE_INFO 구조체로 반환됩니다. 이 속성을 쿼리할 때 전달된 SessionHandle 및 UnitId 매개 변수는 유효해야 하고 Identity 매개 변수는 NULL이어야 하며 SubFactor 매개 변수는 WINBIO_SUBTYPE_NO_INFORMATION 합니다.
WINBIO_PROPERTY_EXTENDED_STORAGE_INFO 4	이 읽기 전용 생체 인식 속성에는 특정 생체 인식 단위에 연결된 스토리지 구성 요소의 기능 및 특성에 대한 확장된 정보가 포함되어 있습니다. 속성 쿼리의 결과는 WINBIO_EXTENDED_STORAGE_INFO 구조체로 반환됩니다. 이 속성을 쿼리할 때 전달된 SessionHandle 및 UnitId 매개 변수는 유효해야 하고 Identity 매개 변수는 NULL이어야 하며 SubFactor 매개 변수는 WINBIO_SUBTYPE_NO_INFORMATION 합니다.
WINBIO_PROPERTY_EXTENDED_ENROLLMENT_STATUS 5	이 읽기 전용 생체 인식 속성에는 특정 생체 인식 단위에서 진행 중인 등록의 상태 대한 확장 정보가 포함됩니다. 속성 쿼리의 결과는 WINBIO_EXTENDED_STORAGE_INFO 구조체로 반환됩니다. BU에서 등록이 진행 중이 아니면 반환된 구조체의 TemplateStatus 멤버에 WINBIO_E_INVALID_OPERATION 값이 있습니다. 이 속성을 쿼리할 때 전달된 SessionHandle 및 UnitId 매개 변수는 유효해야 하고 Identity 매개 변수는 NULL이어야 하며 SubFactor 매개 변수는 WINBIO_SUBTYPE_NO_INFORMATION 합니다.
WINBIO_PROPERTY_ANTI_SPOOF_POLICY 1	이 읽기-쓰기 생체 인식 속성에는 특정 사용자 계정에 대한 스푸핑 방지 정책 값이 포함됩니다. 속성 작업은 WINBIO_ANTI_SPOOF_POLICY 구조체로 지정되거나 반환됩니다. 이 속성을 쿼리할 때 전달된 SessionHandle 매개 변수는 유효해야 하고 UnitId 매개 변수는 0이어야 하며, Identity 매개 변수는 쿼리하거나 변경할 계정 SID(보안 식별자) 값이어야 하며( SessionHandle과 연결된 SID 값을 사용하고 NULL을 지정하려면) SubFactor 매개 변수를 WINBIO_SUBTYPE_NO_INFORMATION 합니다. 와일드카드 ID를 사용하여 이 속성을 쿼리하면 이 정책의 시스템 기본값이 반환됩니다. 권한이 없는 사용자는 자신의 정책 설정만 수정할 수 있습니다. 권한이 없는 사용자가 다른 사용자 계정을 나타내거나 와일드카드 식별자 값을 포함하는 Identity 매개 변수를 사용하여 WinBioSetProperty 함수를 호출하려고 하면 속성 쓰기 시도가 실패합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 10 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2016 [데스크톱 앱만 해당]
헤더	Winbio_types.h(Winbio.h 포함)