[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
Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.
