IHttpUser::GetUserName (Método)
Devuelve el nombre de usuario.
Sintaxis
virtual PCWSTR GetUserName(
VOID
) = 0;
Parámetros
Este método no toma parámetros.
Valor devuelto
Puntero a una cadena Unicode terminada en null constante que contiene el nombre de usuario.
Comentarios
El valor devuelto depende del tipo de autenticación. El tipo de autenticación se devuelve desde el método GetAuthenticationType .
En la tabla siguiente se muestran los tipos de autenticación con los valores o el patrón de nombre de usuario asociados.
| Tipo de autenticación | Nombre de usuario |
|---|---|
| Anónimas | cadena vacía. |
| Básico | Dominio\nombre de usuario |
| Digest | domain\username o username |
| Formularios | username |
| Windows | Dominio\nombre de usuario |
Notas para los implementadores
IHttpUser Los implementadores son responsables de la administración de memoria con estos datos; por lo tanto, IHttpUser los implementadores que usan la asignación de memoria dinámica deben liberarse o llamar delete al PCWSTR puntero cuando ya no sea necesario.
Notas para autores de la llamada
IHttpUser Los implementadores son responsables de la administración de memoria con estos datos; Por lo tanto, IHttpUser los clientes no deben liberar ni llamar delete al puntero devuelto PCWSTR cuando estos datos ya no son necesarios. Además, los clientes no deben convertir estos datos en un puntero que no es ni const cambiar el estado de la memoria a la que hace referencia este PCWSTR; de lo contrario, se producirá una infracción de acceso o los datos no serán válidos.
Ejemplo
En el ejemplo de código siguiente se muestra cómo crear un módulo HTTP que borra los encabezados de respuesta y el cuerpo y, a continuación, devuelve información de usuario al cliente como un documento XML.
El código anterior escribe XML en el flujo de respuesta similar al siguiente.
<?xml version="1.0" ?>
<user userName="DOMAIN\user" />
El módulo debe exportar la función RegisterModule . Puede exportar esta función mediante la creación de un archivo de definición de módulo (.def) para el proyecto, o bien puede compilar el módulo mediante el /EXPORT:RegisterModule modificador . Para obtener más información, vea Tutorial: Creación de un módulo HTTP de Request-Level mediante código nativo.
Opcionalmente, puede compilar el código mediante la __stdcall (/Gz) convención de llamada en lugar de declarar explícitamente la convención de llamada para cada función.
Requisitos
| Tipo | Descripción |
|---|---|
| Remoto | - IIS 7.0 en Windows Vista - IIS 7.5 en Windows 7 - IIS 8.0 en Windows 8 - IIS 10.0 en Windows 10 |
| Servidor | - IIS 7.0 en Windows Server 2008 - IIS 7.5 en Windows Server 2008 R2 - IIS 8.0 en Windows Server 2012 - IIS 8.5 en Windows Server 2012 R2 - IIS 10.0 en Windows Server 2016 |
| Producto | - 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 |
| Encabezado | Httpserv.h |
Consulte también
IHttpUser (Interfaz)
IHttpUser::GetPassword (Método)
IHttpUser::GetRemoteUserName (Método)