IPSTOVERRIDEREQ::RegisterTrustedPSTOverrideHandler
Applies to: Outlook 2013 | Outlook 2016
Initiates the unlocking procedure for a Personal Folders (.pst) file.
HRESULT RegisterTrustedPSTOverrideHandler (
LPCWSTR pwzDllPath,
LPVOID pvClientData
);
Parameters
pwzDllPath
[in] A pointer to the path of a third-party dynamic-link library (DLL).
pvClientData
[in] A pointer to client data, which will be passed by the PST provider into subsequent calls to the DLL's HrTrustedPSTOverrideHandlerCallback function. This client data may be used by the DLL to assist in verifying whether the PST should be unlocked.
Return value
S_OK
The function call was successful.
Remarks
The DLL specified by the wzDllPath parameter must be signed using a digital certificate. The DLL must also export a function with the following signature.
extern "C" HRESULT __cdecl HrTrustedPSTOverrideHandlerCallback(IMsgStore *pmstore, IUnknown *pOverride, LPVOID pvClientData)
This function will be called with a pointer to the IMsgStore object for the PST, a pointer to an IUnknown object that implements the IPSTOVERRIDE1 interface, and a pointer to the data originally supplied through pvClientData.