Функция NPGetUser (npapi.h)
Извлекает значение текущего имени пользователя по умолчанию или имени пользователя, используемого для установления сетевого подключения.
Синтаксис
DWORD NPGetUser(
[in] LPWSTR lpName,
[out] LPWSTR lpUserName,
[in, out] LPDWORD lpnBufferLen
);
Параметры
[in] lpName
Указатель на имя локального устройства, которое интересует вызывающий объект, или удаленное имя ресурса, к которому пользователь установил подключение. Этот параметр может иметь значение NULL или пустую строку, если вызывающий объект заинтересован в имени пользователя, вошедшего в систему. Если передается удаленное имя ресурса и пользователь подключен к нему с использованием разных имен, возможно, поставщик не сможет определить, какое имя пользователя следует вернуть. В этом случае поставщик может сделать произвольный выбор среди возможных имен пользователей.
[out] lpUserName
Указатель на буфер для получения имени пользователя. Это должно быть имя, которое можно передать в функцию NPAddConnection или NPAddConnection3 , чтобы повторно установить соединение с тем же именем пользователя.
[in, out] lpnBufferLen
Указатель на размер (в символах) буфера lpUserName . Если вызов завершается сбоем, так как буфер недостаточно велик, это расположение будет использоваться для возврата требуемого размера буфера.
Возвращаемое значение
Если функция выполнена успешно, она должна вернуть WN_SUCCESS. В противном случае он должен вернуть код ошибки, который может быть одним из следующих.
Код возврата | Описание |
---|---|
|
Значение в параметре lpName не является именем перенаправленного устройства или подключенным удаленным именем. |
|
Буфер lpUserName слишком мал. |
|
Сеть отсутствует. |
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows XP [только классические приложения] |
Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
Целевая платформа | Windows |
Header | npapi.h |