Oharra
Baimena behar duzu orria atzitzeko. Direktorioetan saioa has dezakezu edo haiek alda ditzakezu.
Baimena behar duzu orria atzitzeko. Direktorioak alda ditzakezu.
Devuelve los datos de usuario personalizados por nombre.
Sintaxis
virtual PVOID GetUserVariable(
IN PCSTR pszVariableName
) = 0;
Parámetros
pszVariableName
[IN] Puntero a una cadena terminada en null constante que contiene el nombre de variable de los datos que se van a recuperar.
Valor devuelto
Puntero void que contiene los datos personalizados de difusión vertical.
Comentarios
El valor predeterminado es HTTP_USER_VARIABLE_SID, que se define en el archivo de encabezado Httpserv.h.
Notas para los implementadores
Los implementadores de IHttpUser 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 delete el void 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, los IHttpUser clientes no deben liberar o delete el puntero devuelto void cuando estos datos ya no son necesarios. Además, los clientes no deben cambiar el estado de la memoria a la que hace referencia este void puntero, ya que 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 y el cuerpo de la respuesta y, a continuación, devuelve información de usuario al cliente como un documento XML.
El código anterior escribe XML similar al siguiente en el flujo de respuesta.
<?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 |