BCryptCreateContext function

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

The BCryptCreateContext function creates a new CNG configuration context.

Syntax

NTSTATUS WINAPI BCryptCreateContext(
  _In_     ULONG                 dwTable,
  _In_     LPCWSTR               pszContext,
  _In_opt_ PCRYPT_CONTEXT_CONFIG pConfig
);

Parameters

dwTable [in]

Identifies the configuration table to create the context in. This can be one of the following values.

Value	Meaning
CRYPT_LOCAL	Create the context in the local-machine configuration table.
CRYPT_DOMAIN	This value is not available for use.

 

pszContext [in]

A pointer to a null-terminated Unicode string that contains the identifier of the context to create.

pConfig [in, optional]

A pointer to a CRYPT_CONTEXT_CONFIG structure that contains additional configuration data for the new context. This parameter can be NULL if it is not needed.

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.

Remarks

BCryptCreateContext can be called only in user mode.

Requirements