BCryptConfigureContext function (bcrypt.h)
[BCryptConfigureContext is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions.]
The BCryptConfigureContext function sets the configuration information for an existing CNG context.
Syntax
NTSTATUS BCryptConfigureContext(
[in] ULONG dwTable,
[in] LPCWSTR pszContext,
[in] PCRYPT_CONTEXT_CONFIG pConfig
);
Parameters
[in] dwTable
Identifies the configuration table that the context exists in. This can be one of the following values.
Value | Meaning |
---|---|
|
The context exists in the local-machine configuration table. |
|
This value is not available for use. |
[in] pszContext
A pointer to a null-terminated Unicode string that contains the identifier of the context to set the configuration information for.
[in] pConfig
The address of a CRYPT_CONTEXT_CONFIG structure that contains the new context configuration information.
Return value
Returns a status code that indicates the success or failure of the function.
Possible return codes include, but are not limited to, the following.
Return code | Description |
---|---|
|
The function was successful. |
|
One or more parameters are not valid. |
|
A memory allocation failure occurred. |
Remarks
BCryptConfigureContext can be called only in user mode.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows Vista [desktop apps only] |
Minimum supported server | Windows Server 2008 [desktop apps only] |
Target Platform | Windows |
Header | bcrypt.h |
Library | Bcrypt.lib |
DLL | Bcrypt.dll |