PStoreEnumProviders function

[Protected Storage (Pstore) is available for use in Windows Server 2003 and Windows XP. It is only available for read-only operations in Windows Server 2008 and Windows Vista, but may be unavailable in subsequent versions. Pstore uses an older implementation of data protection. Developers are strongly encouraged to take advantage of the stronger data protection provided by the CryptProtectData and CryptUnprotectData functions.]

Gets an enumerator object that can be used in turn to enumerate the protected storage providers that are currently installed on the system.


HRESULT PStoreEnumProviders(
   DWORD                dwFlags,
   IEnumPStoreProviders **ppenum



This parameter is not used and must be zero.


A pointer to a pointer to an IEnumPStoreProviders interface that can be used to enumerate installed providers.

Return value

This function returns an HRESULT.


The protected storage component has a provider-based architecture. Applications that make use of protected storage can specify which of the installed providers to use when storing and retrieving their data.

The PStoreEnumProviders function is used to enumerate the installed protected storage providers. Each provider is identified by a globally unique identifier (GUID).

Up to this time, only one protected storage provider has ever been written. Given that the protected storage service is currently deprecated, it is very unlikely that any additional providers will ever be produced. As a result, this function should not be used for any purpose.

This function has no associated import library; you must call it using the LoadLibrary and GetProcAddress functions.






See also