BCryptAddContextFunction function (bcrypt.h)
[BCryptAddContextFunction is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions.]
The BCryptAddContextFunction function adds a cryptographic function to the list of functions that are supported by an existing CNG context.
Syntax
NTSTATUS BCryptAddContextFunction(
[in] ULONG dwTable,
[in] LPCWSTR pszContext,
[in] ULONG dwInterface,
[in] LPCWSTR pszFunction,
[in] ULONG dwPosition
);
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 add the function to.
[in] dwInterface
Identifies the cryptographic interface to add the function to. This can be one of the following values.
[in] pszFunction
A pointer to a null-terminated Unicode string that contains the identifier of the cryptographic function to add.
[in] dwPosition
Specifies the position in the list at which to insert this function. The function is inserted at this position ahead of any existing functions. The CRYPT_PRIORITY_TOP value is used to insert the function at the top of the list. The CRYPT_PRIORITY_BOTTOM value is used to insert the function at the end of the list.
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. |
|
The context could not be found. |
Remarks
If the function added is already in the list, it will be removed and inserted at the new position.
BCryptAddContextFunction can be called only in user mode.
Requirements
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 |
See also
Feedback
Submit and view feedback for