다음을 통해 공유

SslGenerateSessionKeys 함수

  • 아티클

SslGenerateSessionKeys 함수는 SSL(Secure Sockets Layer Protocol) 세션 키 집합을 생성합니다.

구문

SECURITY_STATUS WINAPI SslGenerateSessionKeys(
  _In_  NCRYPT_PROV_HANDLE hSslProvider,
  _In_  NCRYPT_KEY_HANDLE  hMasterKey,
  _Out_ NCRYPT_KEY_HANDLE  *phReadKey,
  _Out_ NCRYPT_KEY_HANDLE  *phWriteKey,
  _In_  PNCryptBufferDesc  pParameterList,
  _In_  DWORD              dwFlags
);

매개 변수

hSslProvider [in]

SSL 프로토콜 공급자에 대한 핸들은 instance.

hMasterKey [in]

master 키 개체에 대한 핸들입니다.

phReadKey [out]

반환된 읽기 키 핸들에 대한 포인터입니다.

phWriteKey [out]

반환된 쓰기 키 핸들에 대한 포인터입니다.

pParameterList [in]

키 교환 작업의 일부로 사용되는 정보를 포함하는 NCryptBuffer 버퍼 배열에 대한 포인터입니다. 정확한 버퍼 집합은 사용되는 프로토콜 및 암호 도구 모음에 따라 달라집니다. 최소한 목록에는 클라이언트 및 서버 제공 임의 값이 포함된 버퍼가 포함됩니다.

dwFlags [in]

이 매개 변수는 나중에 사용하도록 예약되어 있습니다.

반환 값

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

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

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

반환 코드/값 설명
NTE_NO_MEMORY
0x8009000EL
 필요한 버퍼를 할당하는 데 메모리가 부족합니다.
NTE_INVALID_HANDLE
0x80090026L
 제공된 핸들 중 하나가 잘못되었습니다.
NTE_INVALID_PARAMETER
0x80090027L
 phReadKey 또는 phWriteKey 매개 변수가 null입니다.

요구 사항

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