OpenClusterCryptProvider function (resapi.h)

Article
02/22/2024

Opens a handle to a Cryptographic Service Provider (CSP) in order to manage the encryption of Checkpointing data for a cluster resource. The POPEN_CLUSTER_CRYPT_PROVIDER type defines a pointer to this function.

Syntax

HCLUSCRYPTPROVIDER OpenClusterCryptProvider(
  [in] LPCWSTR lpszResource,
  [in] LPCTSTR lpszProvider,
  [in] DWORD   dwType,
  [in] DWORD   dwFlags
);

Parameters

[in] lpszResource

A pointer to a null-terminated Unicode string that contains the name of the cluster resource that is associated with the Checkpointing data.

[in] lpszProvider

A pointer to a null-terminated Unicode string that contains the name of the CSP.

[in] dwType

A bitmask that specifies the CSP type.

This parameter can be set to one of the following values:

PROV_RSA_FULL (1)

PROV_RSA_SIG (2)

PROV_DSS (3)

PROV_FORTEZZA (4)

PROV_MS_EXCHANGE (5)

PROV_SSL (6)

PROV_RSA_SCHANNEL (12)

PROV_DSS_DH (13)

PROV_EC_ECDSA_SIG (14)

PROV_EC_ECNRA_SIG (15)

PROV_EC_ECDSA_FULL (16)

PROV_EC_ECNRA_FULL (17)

PROV_DH_SCHANNEL (18)

PROV_SPYRUS_LYNKS (20)

PROV_RNG (21)

PROV_INTEL_SEC (22)

PROV_REPLACE_OWF (23)

PROV_RSA_AES (24)

[in] dwFlags

The flags that specify the settings for the operation. This parameter can be set to the default value "0", or CLUS_CREATE_CRYPT_CONTAINER_NOT_FOUND (0x0001).

Return value

If the operation completes successfully, this function returns a HCLUSCRYPTPROVIDER structure containing a handle to the CSP.

Requirements

Requirement	Value
Minimum supported client	None supported
Minimum supported server	Windows Server 2012 R2
Target Platform	Windows
Header	resapi.h
Library	ResUtils.lib
DLL	ResUtils.dll