PvkPrivateKeyAcquireContextFromMemory function
The PvkPrivateKeyAcquireContextFromMemory function creates a temporary container in the cryptographic service provider (CSP) and loads a private key from memory into the container.
Syntax
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 );
Parameters
- pwszProvName [in]
-
A pointer to a null-terminated string that contains the name of the CSP whose type is requested in dwProvType.
- dwProvType [in]
-
A DWORD value for the CSP type. For more information about CSP types, see Cryptographic Provider Types.
- pbData [in]
-
A pointer to a buffer to receive the context data. The caller must provide this resource.
- cbData [in]
-
A DWORD value that specifies the size, in bytes, of the pbData buffer. The caller must provide this value.
- hwndOwner [in]
-
If a password is required to decrypt the context data pointed to by the pbData parameter, this parameter is a handle to the parent of the dialog box; otherwise, it is NULL.
- pwszKeyName [in]
-
A pointer to a null-terminated string that contains the name of the key to retrieve.
- pdwKeySpec [in, out, optional]
-
A pointer to a DWORD value that specifies the type of key. Possible values include AT_KEYEXCHANGE or AT_SIGNATURE.
- phCryptProv [out]
-
A pointer to a handle for the CSP.
- ppwszTmpContainer [out]
-
The address of a pointer to a null-terminated string for the temporary container name. The PvkPrivateKeyAcquireContextFromMemory function provides the buffer for this string and initializes it. When calling PvkPrivateKeyAcquireContextFromMemory, the address should point to a NULL value.
Return value
Upon success, this function returns TRUE. The PvkPrivateKeyAcquireContextFromMemory function returns FALSE if it fails.
Requirements
|
Minimum supported client |
Windows XP [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows Server 2003 [desktop apps only] |
|
DLL |
|