Функция NPGetUser (npapi.h)

Статья
03/13/2024

Извлекает значение текущего имени пользователя по умолчанию или имени пользователя, используемого для установления сетевого подключения.

Синтаксис

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. В противном случае он должен вернуть код ошибки, который может быть одним из следующих.

Код возврата	Описание
WN_NOT_CONNECTED	Значение в параметре lpName не является именем перенаправленного устройства или подключенным удаленным именем.
WN_MORE_DATA	Буфер lpUserName слишком мал.
WN_NO_NETWORK	Сеть отсутствует.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	npapi.h