estructura RPC_ENDPOINT_TEMPLATEA (rpcdce.h)
La estructura RPC_ENDPOINT_TEMPLATE especifica las propiedades de un punto de conexión de servidor del grupo de interfaz RPC, incluida la secuencia de protocolos y el nombre.
Sintaxis
typedef struct {
unsigned long Version;
RPC_CSTR ProtSeq;
RPC_CSTR Endpoint;
void *SecurityDescriptor;
unsigned long Backlog;
} RPC_ENDPOINT_TEMPLATEA, *PRPC_ENDPOINT_TEMPLATEA;
Miembros
Version
Este campo está reservado y debe establecerse en 0.
ProtSeq
Puntero a un identificador de cadena de la secuencia de protocolos para registrarse con la biblioteca en tiempo de ejecución rpc. Solo se admiten ncalrpc, ncacn_ip_tcp y ncacn_np. Este valor no debe ser NULL.
Endpoint
Puntero opcional a la información de dirección del punto de conexión que se usará para crear un enlace para la secuencia de protocolo especificada en el parámetro Protseq. Especifique NULL para usar puntos de conexión dinámicos.
SecurityDescriptor
Puntero a un parámetro opcional proporcionado para el subsistema de seguridad. Solo se usa para secuencias de protocolo ncacn_np y ncalrpc. Todas las demás secuencias de protocolo omiten este parámetro. No se recomienda usar un descriptor de seguridad en el punto de conexión para proteger un servidor.
Backlog
Longitud de la cola de trabajos pendientes para la secuencia del protocolo ncacn_ip_tcp. Todas las demás secuencias de protocolo omiten este parámetro. Use RPC_C_PROTSEQ_MAX_REQS_DEFAULT para especificar el valor predeterminado. Vea Comentarios para obtener más información.
Observaciones
El valor proporcionado en trabajo pendiente por las aplicaciones es solo una sugerencia. El tiempo de ejecución de RPC o el proveedor de Windows Sockets pueden invalidar el valor. Por ejemplo, en Windows XP o Windows 2000 Professional, el valor está limitado a 5. Los valores mayores que 5 se omiten y se usan 5 en su lugar. En Windows Server 2003 y Windows 2000 Server, se respetará el valor.
Las aplicaciones deben tener cuidado de pasar valores razonables en trabajo pendiente. Los valores grandes de Server, Advanced Server o Datacenter Server pueden provocar que se use una gran cantidad de memoria de grupo no paginada. El uso de un valor demasiado pequeño también es desfavorable, ya que puede dar lugar a que el RST TCP cumpla los paquetes TCP SYN desde el servidor si se agota la cola de trabajos pendientes.
Un desarrollador de aplicaciones debe equilibrar la superficie de memoria frente a los requisitos de escalabilidad al determinar el valor adecuado para trabajo pendiente.
Nota
El encabezado rpcdce.h define RPC_ENDPOINT_TEMPLATE como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 8 [solo aplicaciones de escritorio] |
| servidor mínimo admitido | Windows Server 2012 [solo aplicaciones de escritorio] |
| encabezado de |
rpcdce.h (include Rpc.h) |