Edit

IPSTOVERRIDE1::SetPersistedRegistrations

  • Article

Applies to: Outlook 2013 | Outlook 2016

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.

See also