ICspInformations::GetCspStatusFromProviderName method (certenroll.h)

The GetCspStatusFromProviderName method retrieves an ICspStatus object for a legacy provider by provider name and supported key operations. This method is web enabled.

Syntax

HRESULT GetCspStatusFromProviderName(
  [in]  BSTR        strProviderName,
  [in]  X509KeySpec LegacyKeySpec,
  [out] ICspStatus  **ppValue
);

Parameters

[in] strProviderName

A BSTR that contains the cryptographic provider name or the provider and algorithm names separated by a comma in the format algorithm_name, provider_name.

[in] LegacyKeySpec

An X509KeySpec enumeration value that specifies whether a key can be used for encryption, signing, or both. This can be one of the following values:

  • XCN_AT_KEYEXCHANGE
  • XCN_AT_SIGNATURE

[out] ppValue

Address of a variable that receives a pointer to an ICspStatus interface that contains information about a cryptographic provider and algorithm pair that satisfies the strProviderName and LegacyKeySpec parameter values.

Return value

If the function succeeds, the function returns S_OK.

If the function fails, it returns an HRESULT value that indicates the error. For a list of common error codes, see Common HRESULT Values.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header certenroll.h
DLL CertEnroll.dll

See also

ICspInformation

ICspInformations