Función RpcBindingCreateA (rpcdce.h)

  • Artículo

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, vea 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; Elegir otra secuencia de protocolo da como resultado la devolución de este código de estado de error.
 
 
Nota Para obtener una lista de códigos de error válidos, vea Rpc Return Values.
 

Comentarios

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. La API RpcBindingCreate 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en 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 Vista [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino Windows
Encabezado rpcdce.h (include Rpc.h)
Library Rpcrt4.lib
Archivo DLL Rpcrt4.dll

Consulte también

RPC_BINDING_HANDLE

RpcBindingBind