Función RpcBindingCreateA (rpcdce.h)

La función RpcBindingCreate crea un nuevo identificador de enlace RPC rápido basado en una plantilla proporcionada.

Sintaxis

RPC_STATUS RpcBindingCreateA(
  [in]           RPC_BINDING_HANDLE_TEMPLATE_V1_A *Template,
  [in, optional] RPC_BINDING_HANDLE_SECURITY_V1_A *Security,
  [in, optional] RPC_BINDING_HANDLE_OPTIONS_V1    *Options,
  [out]          RPC_BINDING_HANDLE               *Binding
);

Parámetros

[in] Template

RPC_BINDING_HANDLE_TEMPLATE estructura que describe el identificador de enlace que va a crear esta llamada. Estos datos se pueden sobrescribir durante la llamada, por lo que la API no mantiene una referencia a estos datos. El autor de la llamada debe liberar la memoria usada por esta estructura cuando la API devuelve.

[in, optional] Security

RPC_BINDING_HANDLE_SECURITY estructura que describe las opciones de seguridad de este identificador de enlace. Estos datos se pueden sobrescribir durante la llamada, por lo que la API no mantiene una referencia a estos datos. El autor de la llamada debe liberar la memoria usada por esta estructura cuando la API devuelve.

Este parámetro es opcional. Si este parámetro se establece en NULL, se usará la configuración de seguridad predeterminada para RPC_BINDING_HANDLE_SECURITY.

[in, optional] Options

RPC_BINDING_HANDLE_OPTIONS estructura que describe opciones adicionales para el identificador de enlace. Estos datos se pueden sobrescribir durante la llamada, por lo que la API no mantiene una referencia a estos datos. El autor de la llamada debe liberar la memoria usada por esta estructura cuando la API devuelve.

Este parámetro es opcional. Si este parámetro se establece en null, se usarán las opciones predeterminadas de RPC_BINDING_HANDLE_OPTIONS.

[out] Binding

RPC_BINDING_HANDLE estructura que contiene el identificador de enlace recién creado. Si esta función no devolvió RPC_S_OK, el contenido de esta estructura no está definido. Para las llamadas RPC no locales, este identificador debe pasarse a RpcBindingBind.

Valor devuelto

Esta función devuelve RPC_S_OK si se realiza correctamente; De lo contrario, se devuelve un código de error RPC_S_*. Para obtener información sobre estos códigos de error, consulte valores devueltos de RPC.

Código devuelto	Descripción
RPC_S_OK	El identificador de enlace se creó correctamente.
RPC_S_CANNOT_SUPPORT	Se solicitó una característica obsoleta de RPC para este identificador de enlace. Nota Las únicas secuencias de protocolo admitidas para esta API son ncalrpc; Al elegir otra secuencia de protocolo, se devuelve este código de estado de error.

 

Nota Para obtener una lista de códigos de error válidos, vea rpc Return Values.

 

Observaciones

El identificador de enlace RPC devuelto por esta API se puede usar con cualquier otra función que acepte un identificador de enlace como parámetro.

Sin embargo, antes de que se puedan realizar llamadas en el identificador de enlace, se debe llamar a RpcBindingBind para que el identificador de enlace esté disponible para las llamadas remotas. El RpcBindingCreate API no toca la red ni intenta comunicarse con el servidor RPC, sino que simplemente crea una estructura de datos interna basada en los valores proporcionados en la plantilla. Una devolución correcta no indica que el servidor RPC está disponible, accesible o especificado correctamente.

Nota

El encabezado rpcdce.h define RpcBindingCreate 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 Vista [aplicaciones de escritorio | Aplicaciones para UWP]
servidor mínimo admitido	Windows Server 2008 [aplicaciones de escritorio | Aplicaciones para UWP]
de la plataforma de destino de	Windows
encabezado de	rpcdce.h (include Rpc.h)
biblioteca de	Rpcrt4.lib
DLL de	Rpcrt4.dll

Consulte también

RPC_BINDING_HANDLE

RpcBindingBind