ICEnroll::put_ProviderType method (xenroll.h)

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

The ProviderType property sets or retrieves the type of provider.

The value of the ProviderType property is passed to the CryptAcquireContext CryptoAPI function. Valid values are determined by the cryptographic service provider (CSP) in use. The default value for this property is 1. This property was first defined in the ICEnroll interface.

This property is read/write.

Syntax

HRESULT put_ProviderType(
  LONG dwType
);

Parameters

dwType

Return value

None

Remarks

For general information about provider types, see Cryptographic Provider Types.

For more information about valid values for the Microsoft Base Cryptographic Provider, see the CryptAcquireContext CryptoAPI function.

For provider type information for other CSPs, see the documentation provided with the CSP.

The ProviderType property value is passed to CryptAcquireContext by using its dwProvType parameter.

The ProviderType property affects the behavior of the following methods:

Examples

DWORD    dwProvType;
HRESULT  hr;

// Get the ProviderType value.
// pEnroll is previously instantiated ICEnroll interface pointer
hr = pEnroll->get_ProviderType(&dwProvType);
if (FAILED( hr ))
    printf("Failed get_ProviderType - %x\n", hr);
else
    printf("ProviderType: %d\n", dwProvType);

// Set the ProviderType value.
hr = pEnroll->put_ProviderType(PROV_MS_EXCHANGE);
if (FAILED(hr))
    printf("Failed put_ProviderType - %x\n", hr);
else
    printf("ProviderType set to %d\n", PROV_MS_EXCHANGE);

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