IPSTOVERRIDE1::SetPersistedRegistrations
Applies to: Office 2010 | Outlook 2010 | Visual Studio
Registers Personal Folders (.pst) files for automatic unlocking, avoiding further calls to the HrTrustedPSTOverrideHandlerCallback.
HRESULT SetPersistedRegistrations(
SPropValue *pmval
);
Parameters
pmval
[in] An SPropValue structure that contains a pointer to the path of the dynamic-link library (DLL) to register. The structure has the following characteristics:A ulPropTag of PROP_TAG(PT_MV_UNICODE, PROP_ID_NULL).
An MVszW value property that is set to an array of null-terminated Unicode character strings. For more information see the SWStringArray topic.
Note
The SPropValue is stored in a MAPI property in the PST’s internal range. This property is inaccessible to ordinary MAPI applications.
Return Value
- S_OK
The function call was successful.
Remarks
Persisted registrations may adversely affect the performance of applications, such as Outlook and Windows Desktop Search, that open PSTs. Consider the performance effect when using or expanding the usage of persisted registrations.
Important
This method is implemented for Unicode only. Further, it will preemptively fail if any of the paths in the array do not have a file name extension of .dll.