Función RpcServerInqBindingHandle (rpcdce.h)

La función RpcServerInqBindingHandle obtiene el identificador de enlace para las llamadas RPC que el subproceso en el que se llama a RpcServerInqBindingHandle .

Sintaxis

RPC_STATUS RpcServerInqBindingHandle(
  RPC_BINDING_HANDLE *Binding
);

Parámetros

Binding

RPC_BINDING_HANDLE estructura que, después de que se realice correctamente, recibe el identificador de enlace para la llamada a la que también llama el subproceso RpcServerInqBindingHandle .

Si se produce un error en la llamada, este parámetro no está definido.

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_*. Esta función no puede producir un error a menos que se llame a en un subproceso que no esté atendiendo actualmente una llamada RPC.

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

 

Comentarios

RpcServerInqBindingHandle se usa para obtener el identificador de enlace de la llamada RPC que se está ejecutando actualmente en el subproceso desde el que también se llama a esta API. Dado que muchas API rpc requieren un identificador de enlace como entrada, esta es una manera cómoda de obtener un identificador de enlace.

Tenga en cuenta que todas las API RPC del lado servidor que toman un identificador de enlace como parámetro le permiten pasar NULL como un valor aceptado. Pasar NULL en lugar de un identificador de enlace indica que se debe usar el identificador de enlace para la llamada RPC que se está ejecutando actualmente en el mismo subproceso. Sin embargo, si llama a una API del lado servidor desde un subproceso independiente, deberá proporcionar un identificador de enlace que no sea NULL.

Si usa identificadores de enlace explícitos y no usa identificadores de contexto específicos del subproceso, el identificador de enlace de la llamada es el primer parámetro de la rutina del administrador del servidor. Sin embargo, si no usa identificadores explícitos o si usa identificadores de contexto, RpcServerInqBindingHandle es la única manera de obtener un identificador de enlace para usarlo en otro subproceso.

Esta API se puede usar tanto para llamadas asincrónicas como sincrónicas, aunque resulta menos útil para las llamadas asincrónicas, ya que el identificador de enlace se puede obtener como estado asincrónico siempre es el primer parámetro para todas las llamadas RPC asincrónicas y el identificador de enlace se puede obtener directamente desde ella mediante RpcAsyncGetCallHandle.

Requisitos

Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	rpcdce.h (include Rpc.h)
Library	Rpcrt4.lib
Archivo DLL	Rpcrt4.dll

Consulte también

RpcAsyncGetCallHandle