ICEnroll4::GetKeyLenEx 메서드(xenroll.h)
[이 메서드는 Windows Server 2008 및 Windows Vista를 기준으로 더 이상 사용할 수 없습니다.]
GetKeyLenEx 메서드는 서명 및 교환 키에 대한 크기 정보를 검색합니다. 이 메서드는 ICEnroll4 인터페이스에서 처음 정의되었습니다.
이 메서드에서 검색한 값은 현재 CSP( 암호화 서비스 공급자 )에 따라 달라집니다.
구문
HRESULT GetKeyLenEx(
[in] LONG lSizeSpec,
[in] LONG lKeySpec,
[out] LONG *pdwKeySize
);
매개 변수
[in] lSizeSpec
검색할 크기 정보의 유형을 나타내는 값입니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.
값 | 의미 |
---|---|
|
최소 키 크기입니다. |
|
최대 키 크기입니다. |
|
키 증분 크기입니다. 자세한 내용은 설명 부분을 참조하세요. |
[in] lKeySpec
크기 정보가 반환되는 키를 지정합니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.
값 | 의미 |
---|---|
|
Exchange 키 |
|
서명 키 |
[out] pdwKeySize
키 크기를 비트 단위로 수신하는 변수에 대한 포인터입니다.
반환 값
C++
메서드가 성공하면 메서드는 S_OK 반환합니다.메서드가 실패하면 오류를 나타내는 HRESULT 값이 반환됩니다. 일반적인 오류 코드 목록은 일반적인 HRESULT 값을 참조하세요.
VB
키 크기를 비트 단위로 나타내는 값입니다.설명
CSP가 이 메서드를 지원하지 않으면 오류가 반환됩니다.
XEKL_KEYSIZE_INC 값에 대한 자세한 내용은 CryptGetProvParam 참조 페이지의 PP_SIG_KEYSIZE_INC 사용량을 참조하세요.
예제
DWORD dwExchMin, dwExchMax, dwSignDef, dwSignInc;
// Determine the minimum and maximum key length values.
// hr is HRESULT variable.
hr = pEnroll4->GetKeyLenEx( XEKL_KEYSIZE_MIN,
XEKL_KEYSPEC_KEYX,
&dwExchMin );
if ( FAILED( hr ) )
printf("Failed GetKeyLenEx for Exchange Minimum [%x]\n", hr);
else
printf("Exchange key Min: %d\n", dwExchMin);
hr = pEnroll4->GetKeyLenEx( XEKL_KEYSIZE_MAX,
XEKL_KEYSPEC_KEYX,
&dwExchMax );
if ( FAILED( hr ) )
printf("Failed GetKeyLenEx for Exchange Maximum [%x]\n", hr);
else
printf("Exchange key Max: %d\n", dwExchMax );
hr = pEnroll4->GetKeyLenEx( XEKL_KEYSIZE_DEFAULT,
XEKL_KEYSPEC_SIG,
&dwSignDef );
if ( FAILED( hr ) )
printf("Failed GetKeyLenEx for Signature Default "
"Key size [%x]\n", hr);
else
printf("Signature key default size: %d\n", dwSignDef );
hr = pEnroll4->GetKeyLenEx( XEKL_KEYSIZE_INC,
XEKL_KEYSPEC_SIG,
&dwSignInc );
if ( FAILED( hr ) )
printf("Failed GetKeyLenEx for Signature "
"Key Size Increment [%x]\n", hr);
else
printf("Signature key increment size: %d\n", dwSignInc );
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows XP [데스크톱 앱만 해당] |
지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
대상 플랫폼 | Windows |
헤더 | xenroll.h |
라이브러리 | Uuid.lib |
DLL | Xenroll.dll |