SslExportKeyingMaterial 함수

RFC 5705 표준에 따라 키 지정 자료를 내보냅니다. 이 함수는 TLS 의사도란도 함수를 사용하여 키 지정 재질의 바이트 버퍼를 생성합니다. master 비밀, 명확한 ASCII 레이블, 클라이언트 및 서버 임의 값, 필요에 따라 애플리케이션 컨텍스트 데이터에 대한 참조를 사용합니다.

구문

SECURITY_STATUS WINAPI SslExportKeyingMaterial(
  _In_     NCRYPT_PROV_HANDLE hSslProvider,
  _In_     NCRYPT_KEY_HANDLE  hMasterKey,
  _In_     PCHAR              sLabel,
  _In_     PBYTE              pbRandoms,
  _In_     DWORD              cbRandoms,
  _In_opt_ PBYTE              pbContextValue,
  _In_     WORD               cbContextValue,
  _Out_    PBYTE              pbOutput,
  _In_     DWORD              cbOutput,
  _In_     DWORD              dwFlags
);

매개 변수

hSslProvider [in]

TLS 프로토콜 공급자의 핸들은 instance.

hMasterKey [in]

br을 내보낼 키 재질을 만드는 데 사용할 master 키 개체의 핸들입니다.

sLabel [in]

NUL로 종료된 ASCII 레이블 문자열입니다. Schannel은 종료되는 NUL 문자를 pseudorandom 함수에 전달하기 전에 제거합니다.

pbRandoms [in]

TLS 연결의 client_random 및 server_random 값의 연결이 포함된 버퍼에 대한 포인터입니다.

cbRandoms [in]

pbRandoms 버퍼의 길이(바이트)입니다.

pbContextValue [in, optional]

애플리케이션 컨텍스트를 포함하는 버퍼에 대한 포인터입니다. pbContextValue가 NULL인 경우 cbContextValue는 0이어야 합니다.

cbContextValue [in]

pbContextValue 버퍼의 길이(바이트)입니다.

pbOutput [out]

내보낸 키 지정 자료를 받는 버퍼의 주소입니다. cbOutput 매개 변수에는 이 버퍼의 크기가 포함됩니다. 이 값은 NULL일 수 없습니다.

cbOutput [in]

pbOutput 버퍼의 길이(바이트)입니다. 0보다 커야 합니다.

dwFlags [in]

사용되지 않습니다. 0으로 설정해야 합니다.

반환 값

함수가 성공하면 0을 반환합니다.

함수가 실패하면 0이 아닌 오류 값이 반환됩니다.

가능한 반환 코드에는 다음이 포함되지만 이에 국한되지는 않습니다.

반환 코드/값	설명
NTE_INVALID_HANDLE 0x80090026L	제공된 핸들 중 하나가 잘못되었습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 10 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2016 [데스크톱 앱만 해당]
헤더	Sslprovider.h
DLL	Ncrypt.dll