PStoreCreateInstance 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.]

[This function may be altered or unavailable in future versions of Windows. Use the CryptProtectData and CryptUnprotectData functions instead of this function.]

Retrieves an interface pointer to a storage provider.

Syntax

HRESULT __stdcall PStoreCreateInstance(
  _Out_ IPStore        **ppProvider,
  _In_  PST_PROVIDERID *pProviderID,
  _In_  void           *pReserved,
  _In_  DWORD          dwFlags
);

Parameters

ppProvider [out]

A pointer to the retrieved interface pointer for the storage provider. When you finish using the interface, decrement its reference count by calling its IUnknown::Release method. This parameter cannot be NULL.

pProviderID [in]

A pointer to the GUID that identifies the storage provider. If this parameter is NULL, then the base storage provider is used.

pReserved [in]

Reserved; must be NULL.

dwFlags [in]

Reserved; must be zero.

Return value

The return value is an HRESULT. A value of S_OK indicates the function was successful.

Remarks

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

Requirements

Requirement	Value
Header	Pstore.h
DLL	Pstorec.dll

See also

CryptProtectData

CryptUnprotectData