NPGetUser
This is used to determine either the current default user name, or the user identification used to establish a network connection.
DWORD NPGetUser(
LPTSTR lpName,
LPTSTR lpUserID,
LPDWORD lpBufferSize
);
- lpName
- Contains the name of the redirected local device the caller is interested in, or a network name that the user has made a connection to. This may be the empty string if the caller is interested in the name of the user currently logged on to the system. If a network name is passed in, and the user is connected to that resource using different names, it is possible that a provider cannot resolve which user identification to return. In this case the provider may make an arbitrary choice amongst the possible responses.
- lpUserID
- Points to a buffer to receive the user profile name. This is an identification string that the user made to establish the connection (for example, a user name, or group name). Whenever possible, this string should contain sufficient information to reestablish the connection with a call to NPAddConnection without posting a dialog box when a valid password is supplied.
- lpBufferSize
- This is used to specify the size of the buffer passed in, in bytes. If the call fails because the buffer is not big enough, this location will be used to return the required buffer size.
- WN_SUCCESS if the call is successful. This status should be returned if lpName is asking for the network logon name and the network does not provide a network-wide logon to the user (the user must log on to each server individually). Otherwise, an error code is returned. which may include:
WN_NOT_LOGGED_ON |
The user is not logged on to the network. |
WN_NOT_CONNECTED |
lpName not a redirected device nor a connected network name. |
WN_NOT_SUPPORTED |
lpName is a pointer to an empty string and the NP does not provide the capability for network-wide logon. |
WN_MORE_DATA |
The buffer is too small. |
WN_NO_NETWORK |
Network is not present. |