Installable Policy Downloaders

Installable Policy Downloaders

An installable policy downloader must be a Win32 dynamic-link library (DLL). It should export a named function that has the following form.

VOID FAR PASCAL ProcessPolicies(HWND hwndOwner,
LPSTR lpszPolicyFilePath, LPSTR lpszUserName,
LPSTR lpszComputerName, DWORD dwFlags);

hwndOwner

Handle of the parent window.

lpszPolicyFilePath

Address of the full path and filename that MPR would have used to look for the policy file. The downloader may use this parameter, or ignore it and use a different path.

lpszUserName

Address of the user name for the user who is logged on.

lpszComputerName

Address of the local computer name.

dwFlags

Flags. This parameter can be this value:

PP_DISPLAYERRORS

Displays error messages about errors encountered during downloading (including the file is not found, the network resource is not found, and so on). Otherwise, the function should fail silently if there is an error.

In addition to defining and exporting this function, an application must record it in the registry. The following entry should be added under the HKEY_LOCAL_MACHINE\Network\Logon key.

PolicyHandler = "dll name, function name"

In this example, dll name is the name of the DLL containing the function, and function name is the exported function name.