IEnroll4::enumProvidersWStr method

[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

dwIndex [in]

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

dwFlags [in]

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

pbstrProvName [out]

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

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

End of client support

Windows XP

End of server support

Windows Server 2003

Header

Xenroll.h

Library

Uuid.lib

DLL

Xenroll.dll

IID

IID_IEnroll4 is defined as f8053fe5-78f4-448f-a0db-41d61b73446b

See also

IEnroll4

 

 

Show: