estructura de RPC_POLICY (rpcdce.h)

Artículo
08/25/2023

La estructura RPC_POLICY contiene marcas que determinan el enlace en equipos de host múltiple y asignaciones de puertos al usar los protocolos ncacn_ip_tcp y ncadg_ip_udp .

Sintaxis

typedef struct _RPC_POLICY {
  unsigned int  Length;
  unsigned long EndpointFlags;
  unsigned long NICFlags;
} RPC_POLICY, *PRPC_POLICY;

Miembros

Length

Tamaño de la estructura RPC_POLICY , en bytes. El miembro Length permite la compatibilidad con versiones futuras de esta estructura, que pueden contener campos adicionales. Establezca siempre la longitud igual a sizeof(RPC_POLICY) al inicializar la estructura de RPC_POLICY en el código.

EndpointFlags

Conjunto de marcas que determinan los atributos del puerto o los puertos en los que el servidor recibe llamadas a procedimientos remotos. Puede especificar más de una marca (mediante el operador OR bit a bit) del conjunto de valores de una secuencia de protocolo determinada. En la tabla siguiente se enumeran los valores posibles para el miembro EndpointFlags .

Valor	Significado
0	Especifica el valor predeterminado del sistema.
RPC_C_USE_INTERNET_PORT	Asigna el punto de conexión de uno de los puertos definidos en el registro como "Disponible para Internet". Válido solo con secuencias de protocolo ncacn_ip_tcp y ncadg_ip_udp .
RPC_C_USE_INTRANET_PORT	Asigna el punto de conexión de uno de los puertos definidos en el Registro como "Intranet disponible". Válido solo con secuencias de protocolo ncacn_ip_tcp y ncadg_ip_udp .
RPC_C_MQ_TEMPORARY	La cola de recepción del proceso del servidor se eliminará automáticamente cuando se cierre el servidor RPC. Se perderán las llamadas pendientes que aún estén en la cola. Este es el valor predeterminado. Válido solo con la secuencia de protocolo ncadg_mq .
RPC_C_MQ_PERMANENT	Especifica que la cola de recepción del proceso del servidor persiste después de que se cierre el proceso del servidor. El valor predeterminado es que la cola se elimina cuando finaliza el proceso del servidor. Válido solo con ncadg_mq secuencia de protocolo.
RPC_C_MQ_CLEAR_ON_OPEN	Si la cola de recepción ya existe porque se abrió anteriormente como una cola permanente, borre las llamadas pendientes en espera en la cola. Válido solo con la secuencia de protocolo ncadg_mq.
RPC_C_MQ_USE_EXISTING_SECURITY	Si la cola de recepción ya existe, no modifique la configuración existente para la autenticación o el cifrado. Válido solo con la secuencia de protocolo ncadg_mq.
RPC_C_MQ_AUTHENTICATE	La cola de recepción del proceso del servidor solo acepta llamadas autenticadas de clientes. El valor predeterminado es que se aceptan llamadas autenticadas y no autenticadas. Válido solo con ncadg_mq secuencia de protocolo.
RPC_C_MQ_ENCRYPT	Las llamadas al servidor se cifran. El valor predeterminado es que se aceptan llamadas cifradas y sin cifrar. Válido solo con ncadg_mq secuencia de protocolo.
RPC_C_MQ_AUTHN_LEVEL_NONE	La cola de recepción del servidor acepta todas las llamadas de los clientes. Este es el nivel de autenticación predeterminado. Válido solo con el protocolo ncadg_mq .
RPC_C_MQ_AUTHN_LEVEL_PKT_INTEGRITY	Establece la cola de recepción del servidor para que acepte solo las llamadas de cliente que tengan el nivel de autenticación RPC_C_AUTHN_LEVEL_PKT_INTEGRITY o RPC_C_AUTHN_LEVEL_PKT_PRIVACY. Válido solo con la secuencia de protocolo ncadg_mq.
RPC_C_MQ_AUTHN_LEVEL_PKT_PRIVACY	Establece la cola de recepción del servidor para que solo acepte llamadas de cliente que tengan el nivel de autenticación RPC_C_AUTHN_LEVEL_PKT_PRIVACY. Las llamadas con un nivel de autenticación inferior se omiten. Válido solo con la secuencia de protocolo ncadg_mq.

Nota Si el Registro no contiene ninguna de las claves que especifican las directivas predeterminadas, el miembro EndpointFlags no tendrá ningún efecto en tiempo de ejecución. Si falta una clave o contiene un valor no válido, toda la configuración de ese protocolo ( ncacn_ip_tcp, ncadg_ip_udp o ncadg_mq) se marca como no válida y todas las llamadas a las funciones RpcServerUseProtseq* a través de ese protocolo producirán un error.

NICFlags

Directiva para enlazar a tarjetas de interfaz de red (NIC). En la tabla siguiente se enumeran los valores posibles para el miembro NICFlags .

Valor	Significado
0	Enlaza a NIC sobre la base de la configuración del Registro. Use siempre este valor cuando use la estructura RPC_POLICY para definir las propiedades de la cola de mensajes.
RPC_C_BIND_TO_ALL_NICS	Invalida la configuración del Registro y enlaza a todas las NIC. Si falta la clave Bind del Registro, el miembro NICFlags no tendrá ningún efecto en tiempo de ejecución. Si la clave contiene un valor no válido, toda la configuración se marca como no válida y todas las llamadas a RpcServerUseProtseq* producirán un error.

Comentarios

Puede usar la estructura RPC_Policy para establecer directivas para llamadas a procedimientos remotos en tiempo de ejecución. Estas directivas incluyen lo siguiente:

Cola de mensajes: permite al servidor especificar propiedades de cola de mensajes, como seguridad, calidad de entrega y duración de la cola de procesos de servidor. Esta directiva solo es eficaz para las llamadas remotas a través del transporte de cola de mensajes (ncadg_mq).
Asignación de puertos dinámicos: especifica si el punto de conexión registrado por esta aplicación debe ir al conjunto de puertos disponible para Internet o disponible en la intranet.
Enlace selectivo: permite que las máquinas de host múltiple se enlacen de forma selectiva a NIC.

Nota Las directivas de asignación de puertos y enlace selectivo solo son eficaces para las llamadas remotas a través de conexiones TCP ( ncacn_ip_tcp) y UDP ( ncadg_ip_udp). Para obtener más información, consulte Configuración del Registro para asignaciones de puertos y enlace selectivo.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	rpcdce.h (include Rpc.h)