SslEnumCipherSuites 함수
SslEnumCipherSuites 함수는 SSL(Secure Sockets Layer protocol) 프로토콜 공급자에서 지원하는 암호 그룹을 열거합니다.
구문
SECURITY_STATUS WINAPI SslEnumCipherSuites(
_In_ NCRYPT_PROV_HANDLE hSslProvider,
_In_opt_ NCRYPT_KEY_HANDLE hPrivateKey,
_Out_ NCRYPT_SSL_CIPHER_SUITE **ppCipherSuite,
_Inout_ PVOID *ppEnumState,
_In_ DWORD dwFlags
);
매개 변수
-
hSslProvider [in]
-
SSL 프로토콜 공급자 instance 핸들입니다.
-
hPrivateKey [in, optional]
-
프라이빗 키의 핸들입니다. 프라이빗 키를 지정하면 SslEnumCipherSuites 는 프라이빗 키와 호환되는 암호 그룹을 열거합니다. 예를 들어 프라이빗 키가 DSS 키인 경우 DSS_DHE 암호 그룹만 반환됩니다. 프라이빗 키가 RSA 키이지만 원시 암호 해독 작업을 지원하지 않는 경우 SSL2 암호 그룹이 반환되지 않습니다.
프라이빗 키를 지정하지 않는 경우 이 매개 변수를 NULL 로 설정합니다.
참고
hPrivateKey 핸들은 SslOpenPrivateKey 함수를 호출하여 가져옵니다. NCryptOpenKey 함수에서 가져온 핸들은 지원되지 않습니다.
-
ppCipherSuite [out]
-
목록에서 다음 암호 도구 모음의 주소를 수신하는 NCRYPT_SSL_CIPHER_SUITE 구조체에 대한 포인터입니다.
-
ppEnumState [in, out]
-
암호 그룹 목록에서 현재 위치를 나타내는 버퍼에 대한 포인터입니다.
SslEnumCipherSuites에 대한 첫 번째 호출에서 포인터를 NULL로 설정합니다. 각 후속 호출에서 수정되지 않은 값을 SslEnumCipherSuites에 다시 전달합니다.
사용할 수 있는 암호 도구 모음이 더 이상 없는 경우 SslFreeBuffer 함수를 호출하여 ppEnumState를 해제해야 합니다.
-
dwFlags [in]
-
이 매개 변수는 나중에 사용하도록 예약되어 있습니다.
반환 값
함수가 성공하면 0을 반환합니다.
함수가 실패하면 0이 아닌 오류 값이 반환됩니다.
가능한 반환 코드에는 다음이 포함되지만 이에 국한되지는 않습니다.
| 반환 코드/값 | 설명 |
|---|---|
|
필요한 버퍼를 할당하는 데 메모리가 부족합니다. |
|
제공된 핸들 중 하나가 잘못되었습니다. |
|
추가 암호 도구 모음은 지원되지 않습니다. |
설명
SSL 공급자에서 지원하는 모든 암호 그룹을 열거하려면 NTE_NO_MORE_ITEMS 반환될 때까지 루프에서 SslEnumCipherSuites 함수를 호출합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 |
Windows Server 2008 [데스크톱 앱만 해당] |
| 헤더 |
|
| 라이브러리 |
|
| DLL |
|