IEnroll::enumProvidersWStr method (xenroll.h)

[This method is no longer available for use as of Windows Server 2008 and Windows Vista.]

The enumProvidersWStr method retrieves the names of the available cryptographic service providers (CSPs) specified by the ProviderType property. This method was first defined in the IEnroll interface.

Syntax

HRESULT enumProvidersWStr(
  [in]  LONG   dwIndex,
  [in]  LONG   dwFlags,
  [out] LPWSTR *pbstrProvName
);

Parameters

[in] dwIndex

Specifies the ordinal position of the CSP whose name will be retrieved. Specify zero for the first CSP.

[in] dwFlags

Specifies flags that are passed through to the CryptEnumProviders function. Not currently used; specify zero.

[out] pbstrProvName

A pointer to a LPWSTR variable that receives the name of a CSP with the specified property type.

Return value

The return value is an HRESULT. A value of S_OK indicates success. The value ERROR_NO_MORE_ITEMS is returned when there are no more CSPs with the property type indicated by the ProviderType property.

Remarks

If the ProviderType property value has not been set, the default value (usually PROV_RSA_FULL) of ProviderType as set in the registry is used.

The enumProvidersWStr method calls the CryptEnumProviders function.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header xenroll.h
Library Uuid.lib
DLL Xenroll.dll

See also

IEnroll