Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

IPSTOVERRIDE1::SetPersistedRegistrations

Last modified: November 08, 2011

Applies to: Outlook

Registers Personal Folders (.pst) files for automatic unlocking, avoiding further calls to the HrTrustedPSTOverrideHandlerCallback.

HRESULT SetPersistedRegistrations(
  SPropValue *pmval
);

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 Note

The SPropValue is stored in a MAPI property in the PST’s internal range. This property is inaccessible to ordinary MAPI applications.

S_OK

The function call was successful.

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 note 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.

Show:
© 2015 Microsoft