ICEnroll3::p ut_ReuseHardwareKeyIfUnableToGenNew 메서드(xenroll.h)

[이 속성은 Windows Server 2008 및 Windows Vista를 기준으로 더 이상 사용할 수 없습니다.]

ReuseHardwareKeyIfUnableToGenNew 속성은 새 키를 생성할 때 오류가 발생하는 경우 인증서 등록 제어 개체에서 수행한 작업을 결정하는 부울 값을 설정하거나 검색합니다.

이 속성은 ICEnroll3 인터페이스에서 처음 정의되었습니다.

이 속성은 읽기/쓰기가 가능합니다.

구문

HRESULT put_ReuseHardwareKeyIfUnableToGenNew(
  BOOL fReuseHardwareKeyIfUnableToGenNew
);

매개 변수

fReuseHardwareKeyIfUnableToGenNew

반환 값

없음

설명

이 속성은 부울 값입니다. 이 속성은 NTE_TOKEN_KEYSET_STORAGE_FULL 반환하는 암호화 서비스 공급자에 만 영향을 줍니다. 이러한 CSP는 일반적으로 하드웨어 기반입니다. 스마트 카드 예입니다. 이 속성이 true이고 새 키를 생성하는 동안 오류가 발생하면 인증서 등록 제어 개체가 기존 하드웨어 키를 다시 사용합니다. 이 속성이 false이고 새 키를 생성하는 동안 오류가 발생하면 인증서 등록 제어 개체는 기존 하드웨어 키를 다시 사용하지 않고 대신 호출자에게 오류를 전달합니다.

예제

// Code to set the reuse H/W key status.
// hr is HRESULT variable.
hr = pEnroll->put_ReuseHardwareKeyIfUnableToGenNew( FALSE );
if ( FAILED( hr ) )    
    printf("Failed put_ReuseHardwareKeyIfUnableToGenNew [%x]\n", hr);


// Code to retrieve the reuse H/W key status.
BOOL bReuse;

hr = pEnroll->get_ReuseHardwareKeyIfUnableToGenNew( &bReuse );
if ( FAILED( hr ) )
    printf("Failed get_ReuseHardwareKeyIfUnableToGenNew [%x]\n", hr);
else
    printf("Hardware key %s be reused if unable"
        " to generate a new key.\n", bReuse ? "will" : "will not");

요구 사항

추가 정보

CEnroll

ICEnroll3

ICEnroll4