Edit

Share via

BCryptRemoveContextFunction function (bcrypt.h)

  • Article

[BCryptRemoveContextFunction is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions.]

The BCryptRemoveContextFunction function removes a cryptographic function from the list of functions that are supported by an existing CNG context.

Syntax

NTSTATUS BCryptRemoveContextFunction(
  [in] ULONG   dwTable,
  [in] LPCWSTR pszContext,
  [in] ULONG   dwInterface,
  [in] LPCWSTR pszFunction
);

Parameters

[in] dwTable

Identifies the configuration table that the context exists in. This can be one of the following values.

Value Meaning
CRYPT_LOCAL
 The context exists in the local-machine configuration table.
CRYPT_DOMAIN
 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 remove the function from.

[in] dwInterface

Identifies the cryptographic interface to remove the function from. This can be one of the following values.

Value Meaning
BCRYPT_ASYMMETRIC_ENCRYPTION_INTERFACE
 Remove the function from the list of asymmetric encryption functions.
BCRYPT_CIPHER_INTERFACE
 Remove the function from the list of cipher functions.
BCRYPT_HASH_INTERFACE
 Remove the function from the list of hash functions.
BCRYPT_RNG_INTERFACE
 Remove the function from the list of random number generator functions.
BCRYPT_SECRET_AGREEMENT_INTERFACE
 Remove the function from the list of secret agreement functions.
BCRYPT_SIGNATURE_INTERFACE
 Remove the function from the list of signature functions.
NCRYPT_KEY_STORAGE_INTERFACE
 Remove the function from the list of key storage functions.
NCRYPT_SCHANNEL_INTERFACE
 Remove the function from the list of Schannel functions.
NCRYPT_SCHANNEL_SIGNATURE_INTERFACE
 Remove the function from the list of signature suites that Schannel accepts for TLS 1.2.

Windows Vista and Windows Server 2008:  This value is not supported.

[in] pszFunction

A pointer to a null-terminated Unicode string that contains the identifier of the cryptographic function to remove.

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
STATUS_SUCCESS
 The function was successful.
STATUS_INVALID_PARAMETER
 One or more parameters are not valid.
STATUS_NOT_FOUND
 The specified context or function could not be found.

Remarks

BCryptRemoveContextFunction 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

See also

BCryptAddContextFunction