PvkPrivateKeyAcquireContextFromMemory 함수

  • 아티클

중요

이 API는 더 이상 사용되지 않습니다. Microsoft는 이후 릴리스에서 이 API를 제거할 수 있습니다.

 

PvkPrivateKeyAcquireContextFromMemory 함수는 CSP(암호화 서비스 공급자)에 임시 컨테이너를 만들고 메모리에서 컨테이너로 프라이빗 키를 로드합니다.

참고

이 함수에는 연결된 헤더 파일 또는 가져오기 라이브러리가 없습니다. 이 함수를 호출하려면 사용자 정의 헤더 파일을 만들고 LoadLibrary 및 GetProcAddress 함수를 사용하여 Mssign32.dll 동적으로 연결해야 합니다.

 

구문

BOOL WINAPI PvkPrivateKeyAcquireContextFromMemory(
  _In_        LPCWSTR    pwszProvName,
  _In_        DWORD      dwProvType,
  _In_        BYTE       *pbData,
  _In_        DWORD      cbData,
  _In_        HWND       hwndOwner,
  _In_        LPCWSTR    pwszKeyName,
  _Inout_opt_ DWORD      *pdwKeySpec,
  _Out_       HCRYPTPROV *phCryptProv,
  _Out_       LPTSTR     *ppwszTmpContainer
);

매개 변수

pwszProvName [in]

dwProvType에서 형식이 요청된 CSP의 이름을 포함하는 null로 끝나는 문자열에 대한 포인터입니다.

dwProvType [in]

CSP 형식에 대한 DWORD 값입니다. CSP 형식에 대한 자세한 내용은 암호화 공급자 형식을 참조하세요.

pbData [in]

컨텍스트 데이터를 수신하는 버퍼에 대한 포인터입니다. 호출자는 이 리소스를 제공해야 합니다.

cbData [in]

pbData 버퍼의 크기(바이트)를 지정하는 DWORD 값입니다. 호출자는 이 값을 제공해야 합니다.

hwndOwner [in]

pbData 매개 변수가 가리키는 컨텍스트 데이터의 암호를 해독하기 위해 암호가 필요한 경우 이 매개 변수는 대화 상자의 부모에 대한 핸들입니다. 그렇지 않으면 NULL입니다.

pwszKeyName [in]

검색할 키의 이름을 포함하는 null로 끝나는 문자열에 대한 포인터입니다.

pdwKeySpec [in, out, optional]

키 형식을 지정하는 DWORD 값에 대한 포인터입니다. 가능한 값에는 AT_KEYEXCHANGE 또는 AT_SIGNATURE 포함할 수 있습니다.

phCryptProv [out]

CSP의 핸들에 대한 포인터입니다.

ppwszTmpContainer [out]

임시 컨테이너 이름의 null로 끝나는 문자열에 대한 포인터의 주소입니다. PvkPrivateKeyAcquireContextFromMemory 함수는 이 문자열에 대한 버퍼를 제공하고 초기화합니다. PvkPrivateKeyAcquireContextFromMemory를 호출할 때 주소는 NULL 값을 가리킵니다.

반환 값

성공하면 이 함수는 TRUE를 반환 합니다. PvkPrivateKeyAcquireContextFromMemory 함수는 실패하면 FALSE를 반환합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트
 Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버
 Windows Server 2003 [데스크톱 앱만 해당]
DLL
Mssign32.dll