estructura RPC_ENDPOINT_TEMPLATEW (rpcdce.h)

  • Artículo

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_WSTR      ProtSeq;
  RPC_WSTR      Endpoint;
  void          *SecurityDescriptor;
  unsigned long Backlog;
} RPC_ENDPOINT_TEMPLATEW, *PRPC_ENDPOINT_TEMPLATEW;

Miembros

Version

Este campo está reservado y debe establecerse en 0.

ProtSeq

Puntero a un identificador de cadena de la secuencia de protocolo 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.

Comentarios

El valor proporcionado en Trabajos pendientes por 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 se limita 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 hacer que se use una gran cantidad de memoria de grupo no paginada. El uso de un valor demasiado pequeño también es favorable, ya que puede dar lugar a que tcp SYN cumpla los paquetes TCP RST 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 Convenciones para prototipos de función.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2012 [solo aplicaciones de escritorio]
Encabezado rpcdce.h (incluir Rpc.h)

Consulte también

RpcServerInqBindings