IHttpUser::GetUserVariable (Método)

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

Consulte también

IHttpUser (interfaz)