Función RpcServerUseAllProtseqsEx (rpcdce.h)
La función RpcServerUseAllProtseqsEx indica a la biblioteca en tiempo de ejecución rpc que use todas las secuencias de protocolo admitidas para recibir llamadas a procedimiento remoto.
RPC_STATUS RpcServerUseAllProtseqsEx(
unsigned int MaxCalls,
void *SecurityDescriptor,
PRPC_POLICY Policy
);
MaxCalls
Longitud de la cola de trabajos pendientes para la secuencia de 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 la sección Comentarios.
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. Este parámetro no aparece en la especificación DCE de esta API.
Policy
Puntero a la estructura de RPC_POLICY , que permite invalidar las directivas predeterminadas para la asignación dinámica de puertos y el enlace a tarjetas de interfaz de red (NIC) en equipos con varios hogares (equipos con varias tarjetas de red).
Valor | Significado |
---|---|
|
La llamada se realizó correctamente. |
|
No hay secuencias de protocolo admitidas. |
|
La memoria suficiente no está disponible. |
|
El descriptor de seguridad no es válido. |
Si se establece el campo NICFlags de la estructura de RPC_POLICY en cero, esta API extendida es funcionalmente equivalente a RpcServerUseAllProtseqs original y el servidor se enlazará a NIC en función de la configuración del registro del sistema. Para obtener información sobre cómo la configuración del Registro define los puertos de Internet e intranet disponibles, consulte Configuración del Registro para asignaciones de puertos y enlace selectivo.
Para cada secuencia de protocolo registrada por un servidor, la biblioteca en tiempo de ejecución rpc crea uno o varios puntos de conexión a través de los cuales el servidor recibe solicitudes de llamada a procedimiento remoto. La biblioteca en tiempo de ejecución rpc crea diferentes puntos de conexión para cada secuencia de protocolo. El nombre del punto de conexión lo genera el tiempo de ejecución de RPC o el sistema operativo. Por ejemplo, para ncacn_ip_tcp, el número de puerto viene determinado dinámicamente por el tiempo de ejecución de RPC, en función de la disponibilidad y la configuración del Registro.
Las aplicaciones deben tener cuidado de pasar valores razonables en MaxCalls. 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 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 MaxCalls.
Cuando el equipo está configurado para usar el enlace selectivo, la devolución correcta no garantiza que el servidor haya creado puntos de conexión para todas las interfaces de red presentes en el equipo. Es posible que el tiempo de ejecución de RPC no escuche en algunas interfaces de red en función de la configuración de enlace selectivo. Además, si una interfaz aún no ha recibido una dirección IP mediante DHCP, el servidor RPC no escucha en la interfaz de red hasta que se le asigne una dirección DHCP. Una devolución correcta implica que el servidor está escuchando en al menos una interfaz de red; la lista completa de los identificadores de enlace sobre los que se pueden recibir llamadas a procedimiento remoto se puede obtener con una llamada a la función RpcServerInqBindings .
Para registrar selectivamente secuencias de protocolo, un servidor llama a RpcServerUseProtseqEx, RpcServerUseProtseqIfEx o RpcServerUseProtseqEpEx. Consulte Enlace del lado servidor para obtener una descripción de las rutinas a las que normalmente llamará un servidor después de registrar secuencias de protocolo.
Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
Plataforma de destino | Windows |
Encabezado | rpcdce.h (include Rpc.h) |
Library | Rpcrt4.lib |
Archivo DLL | Rpcrt4.dll |
Configuración del Registro para asignaciones de puertos y enlace selectivo