MPR calls this function to notify the credential manager that a logon event has occurred, allowing the credential manager to return a logon script. The NPLogonNotify function is implemented by a credential manager DLL.
DWORD APIENTRY NPLogonNotify( _In_ PLUID lpLogon, _In_ LPCWSTR lpAuthentInfoType, _In_ LPVOID lpAuthentInfo, _In_ LPCWSTR lpPreviousAuthentInfoType, _In_ LPVOID lpPreviousAuthentInfo, _In_ LPWSTR lpStationName, _In_ LPVOID StationHandle, _Out_ LPWSTR *lpLogonScript );
- lpLogon [in]
Pointer to the identifier of the session that just logged on.
- lpAuthentInfoType [in]
Pointer to a string that identifies the type of structure pointed to by lpAuthentInfo.
When Microsoft is the primary authenticator, one of the following strings is specified for interactive and service controller logons.
- lpAuthentInfo [in]
Pointer to a structure that contains the credentials used to successfully log the user on through the primary authenticator.
When Microsoft is the primary authenticator (that is, when lpAuthentifoType is "MSV1_0:Interactive" or "Kerberos:Interactive"), the structure used is MSV1_0_INTERACTIVE_LOGON or KERB_INTERACTIVE_LOGON.
- lpPreviousAuthentInfoType [in]
Pointer to a string that identifies the type of structure pointed to by lpPreviousAuthentInfo. If the pointer is NULL, there was no previous information. The values that are expected here are the same as those in lpAuthentInfoType.
When Microsoft is the primary authenticator, the following string is specified for interactive and service controller logons.
- lpPreviousAuthentInfo [in]
Pointer to a structure that contains the credentials used before the authentication information change. Prior information is provided if the user was forced to change the password (or other authentication information) before logging on. If the user was not forced to change authentication information, this pointer is NULL. The values that are expected here are the same as those in lpAuthentInfo.
- lpStationName [in]
Pointer to a string that specifies the name of the station that the user has logged on to. The station name may be used to determine whether additional (provider-specific) information can be obtained.
When Microsoft is the primary authenticator, one of the following strings will be specified.
- StationHandle [in]
A 32-bit value whose meaning is dependent upon the name (and consequently, the type) of the station specified in lpStationName.
A handle to the owner dialog box (hwndOwner) currently displayed on the screen.
Random data. Do not use.
- lpLogonScript [out]
Pointer to a location where a pointer to a null-terminated string may be returned.
After the function completes, this value may point to a null-terminated string that contains the name of a program to execute plus any parameters the program requires. LocalAlloc should be used to allocate the memory for the returned string. This memory will be freed by MPR when it is no longer needed.
If the function succeeds, the function returns WN_SUCCESS.
If the function fails, it returns an error code, which can be one of the following.
NPLogonNotify is not supported by the credential manager.
The network is not present.
The credential manager is still initializing and is not ready to be called.
The NPLogonNotify function is implemented by credential managers to receive notifications when authentication information changes.
Each credential manager is allowed to return a single command-line string that can be used to execute a logon script. The buffer of this string is allocated by the credential manager. MPR is responsible for freeing it. The string returned in lpLogonScript should contain all the information necessary to run the script as a command line passed to CreateProcess.
If the string requires the command processor to process the string, as in the case of commands or batch files, then the string should be prefixed with cmd /C.
Logon scripts will be run in the user context when the user profile is available. However, environment variables that are set will not be global and will not be available to the initial shell (for example, Program Manager) or any other program run on behalf of the user.
Minimum supported client
|Windows XP [desktop apps only]|
Minimum supported server
|Windows Server 2003 [desktop apps only]|
Build date: 1/2/2013