Метод IHttpUser::GetUserName

Статья
07/19/2023

Возвращает имя пользователя.

Синтаксис

virtual PCWSTR GetUserName(  
   VOID  
) = 0;

Параметры

Этот метод не принимает параметров.

Возвращаемое значение

Указатель на константную строку Юникода, завершающуюся null, которая содержит имя пользователя.

Authentication type (Тип проверки подлинности)	Имя пользователя
Анонимные	Пустая строка.
Basic	Домена\Пользователя
Digest (дайджест)	домен\имя пользователя или имя пользователя
Формы	username
Windows	Домена\Пользователя

Примечания для разработчиков

IHttpUserразработчики отвечают за управление памятью с помощью этих данных; Поэтому разработчики, использующие динамическое выделение памяти, IHttpUser должны освобождать или вызывать PCWSTRdelete указатель, когда он больше не нужен.

Примечания для вызывающих абонентов

IHttpUser разработчики отвечают за управление памятью с помощью этих данных; IHttpUser Поэтому клиенты не должны освобождать или вызывать delete возвращаемый PCWSTR указатель, если эти данные больше не нужны. Кроме того, клиенты не должны приводить эти данные к указателю, который не const является , или изменять состояние памяти, на которую ссылается этот PCWSTRобъект; в противном случае будет вызвано нарушение доступа или данные станут недействительными.

Пример

В следующем примере кода показано, как создать модуль HTTP, который очищает заголовки и текст ответа, а затем возвращает клиенту сведения о пользователе в виде XML-документа.

Приведенный выше код записывает XML-код в поток ответа, как показано ниже.

<?xml version="1.0" ?>  
<user userName="DOMAIN\user" />

Модуль должен экспортировать функцию RegisterModule . Эту функцию можно экспортировать, создав файл определения модуля (DEF) для проекта, или скомпилировать модуль с помощью /EXPORT:RegisterModule параметра . Дополнительные сведения см. в разделе Пошаговое руководство. Создание модуля HTTP Request-Level с помощью машинного кода.

При необходимости можно компилировать код с помощью соглашения о __stdcall (/Gz) вызовах вместо явного объявления соглашения о вызовах для каждой функции.

Требования

Тип	Описание
клиент	— IIS 7.0 в Windows Vista — IIS 7.5 в Windows 7 — IIS 8.0 в Windows 8 — IIS 10.0 в Windows 10
Сервер	— IIS 7.0 в Windows Server 2008 — IIS 7.5 в Windows Server 2008 R2 — IIS 8.0 в Windows Server 2012 — IIS 8.5 в Windows Server 2012 R2 — IIS 10.0 в Windows Server 2016
Продукт	— IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0 — IIS Express 7.5, IIS Express 8.0, IIS Express 10.0
Заголовок	Httpserv.h

См. также:

Интерфейс IHttpUser
Метод IHttpUser::GetPassword
Метод IHttpUser::GetRemoteUserName

Поделиться через