Función RpcServerUseProtseqIfExA (rpcdce.h)
La función RpcServerUseProtseqIfEx indica a la biblioteca en tiempo de ejecución rpc que use la secuencia de protocolo especificada combinada con los puntos de conexión de la especificación de interfaz para recibir llamadas a procedimiento remoto.
Sintaxis
RPC_STATUS RpcServerUseProtseqIfExA(
RPC_CSTR Protseq,
unsigned int MaxCalls,
RPC_IF_HANDLE IfSpec,
void *SecurityDescriptor,
PRPC_POLICY Policy
);
Parámetros
Protseq
Puntero a un identificador de cadena de la secuencia de protocolo para registrarse con la biblioteca en tiempo de ejecución rpc.
MaxCalls
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 la sección Comentarios.
IfSpec
Interfaz que contiene la información del punto de conexión que se usará para crear un enlace para la secuencia de protocolo especificada en el parámetro Protseq .
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 contiene marcas para restringir la asignación de puertos para puertos dinámicos y que permiten a los equipos de host múltiple enlazar de forma selectiva a tarjetas de interfaz de red.
Valor devuelto
| Valor | Significado |
|---|---|
|
La llamada se realizó correctamente. |
|
El punto de conexión de esta secuencia de protocolo no se especifica en el archivo IDL. |
|
La secuencia de protocolo no se admite en este host. |
|
La secuencia de protocolo no es válida. |
|
El formato del punto de conexión no es válido. |
|
El sistema no tiene memoria. |
|
El descriptor de seguridad no es válido. |
Comentarios
Los parámetros y efectos de RpcServerUseProtseqIfEx amplían los de RpcServerUseProtseqIf. La diferencia es el parámetro Policy , que permite restringir la asignación de puertos para puertos dinámicos y permite que los equipos de host múltiple se enlacen selectivamente a tarjetas de interfaz de red.
Establecer el campo NICFlags de la estructura de RPC_POLICY en 0 hace que esta API extendida sea funcionalmente equivalente al rpcServerUseProtseqIf 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 y intranet disponibles, vea Configuring the Registry for Port Allocations and Selective Binding.
Para recibir solicitudes de llamada a procedimientos remotos, un servidor debe registrar al menos una secuencia de protocolo con la biblioteca en tiempo de ejecución RPC. Una aplicación de servidor puede llamar a esta rutina varias veces para registrar secuencias de protocolo adicionales.
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 puntos de conexión diferentes para cada secuencia de protocolo. Sin embargo, cada interfaz del proceso es accesible a través de cualquier punto de conexión. Para obtener más información, vea Escribir un cliente RPC seguro o un servidor.
Para MaxCalls, el valor proporcionado por la aplicación 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 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 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 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 las llamadas a procedimientos remotos se puede obtener con una llamada a la función RpcServerInqBindings.
Para registrar todas las secuencias de protocolo desde el archivo IDL, un servidor llama a RpcServerUseAllProtseqsIfEx. Para obtener más información, vea Enlace del lado servidor. Para obtener una lista de las secuencias de protocolo compatibles con RPC de Microsoft, consulte Enlace de cadenas.
Nota
El encabezado rpcdce.h define RpcServerUseProtseqIfEx 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 XP [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | rpcdce.h (incluir Rpc.h) |
| Library | Rpcrt4.lib |
| Archivo DLL | Rpcrt4.dll |
Consulte también
Escribir un cliente RPC seguro o un servidor
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de