ProcessPolicies

A ProcessPolicies function is a library-defined function exported by an installable policy downloader. The system calls the ProcessPolicies function of an installed policy downloader when a user logs on to the local computer. A ProcessPolicies function merges the information in a policy file into the local registry.

The PFNPROCESSPOLICIES type is a pointer to a ProcessPolicies function. ProcessPolicies is a placeholder for the library-defined function name.

BOOL PASCAL ProcessPolicies(
  HWND hwndOwner,              // handle to the parent window
  LPCTSTR lpszPolicyFilePath,  // path to the policy file
  LPCTSTR lpszUserName,        // name of the logged on user
  LPCTSTR lpszComputerName,    // name of the local computer
  DWORD dwFlags                // error handling flag
);
 

Parameters

hwndOwner

Handle to the parent window.

lpszPolicyFilePath

Pointer to a null-terminated string containing the full path and filename that the system would have used to look for the policy file. The downloader may use this parameter, or ignore it and use a different path.

Windows NT: This is a Unicode string.

Windows 95 and Windows 98: This is an ANSI string.

lpszUserName

Pointer to a null-terminated string containing the name of the logged on user.

Windows NT: This is a Unicode string.

Windows 95 and Windows 98: This is an ANSI string.

lpszComputerName

Pointer to a null-terminated string containing the name of the local computer.

Windows NT: This is a Unicode string.

Windows 95 and Windows 98: This is an ANSI string.

dwFlags

Flags. This parameter can include the following value.

Value	Meaning
PP_DISPLAYERRORS	If this flag is set, the function should display error messages about errors encountered during downloading (including the file is not found, the network resource is not found, and so on). If this flag is not set, the function should fail silently if there is an error.

Return Values

If the function returns a nonzero value, the system runs the default handler.

If the function returns zero, the system does not run the default handler.

See Also

System Policies Overview, System Policies Functions