NPGetPolicyPath

This function is used to determine the default location and filename for a policy file on a given network. The path should be one which network administrators can write to, but users cannot. The directory should also allow unvalidated connections, since policies are retrieved prior to logon. (If unvalidated connections are not available, then policies will be downloaded after user logon and not all settings will take effect immediately.)

DWORD NPGetPolicyPath(
  LPTSTR lpPath,
  LPDWORD lpBufferSize,
  DWORD dwFlags
  );

lpPath

Points to a buffer to receive the path and filename of the policy file. This will be either in UNC or drive-relative form, whichever is supported by the network.

lpBufferSize

This is used to specify the size of the buffer passed in. If the call fails because the buffer is not big enough, this location is used to return the required buffer size.

dwFlags

Any combination of the following values:

GPP_LOADBALANCE

The NP should pick a load-balancing policy path if it supports it. Normally the policy path should be to a known location on a single server, but if the load-balancing flag is set and the NP has a pool of servers that it may use, it should do so.

WN_SUCCESS if the call is successful. Otherwise, GetLastError should be called for extended error information.

WN_MORE_DATA

The buffer is too small.