Función RpcBindingCopy (rpcdce.h)

  • Artículo

La función RpcBindingCopy copia la información de enlace y crea un nuevo identificador de enlace.

Sintaxis

RPC_STATUS RpcBindingCopy(
  RPC_BINDING_HANDLE SourceBinding,
  RPC_BINDING_HANDLE *DestinationBinding
);

Parámetros

SourceBinding

Identificador de enlace de servidor cuya información de enlace a la que se hace referencia se copia.

DestinationBinding

Devuelve un puntero al identificador de enlace de servidor que hace referencia a la información de enlace copiada.

Valor devuelto

Valor Significado
RPC_S_OK
 La llamada se realizó correctamente.
RPC_S_INVALID_BINDING
 El identificador de enlace no era válido.
RPC_S_WRONG_KIND_OF_BINDING
 Este era el tipo incorrecto de enlace para la operación.
 
Nota Para obtener una lista de códigos de error válidos, consulte Rpc Return Values.
 

Comentarios

La función RpcBindingCopy copia la información de enlace de servidor a la que hace referencia el parámetro SourceBinding . RpcBindingCopy usa el parámetro DestinationBinding para devolver un nuevo identificador de enlace de servidor para la información de enlace copiada. RpcBindingCopy también copia la información de autenticación del parámetro SourceBinding en el parámetro DestinationBinding .

Una aplicación usa RpcBindingCopy cuando desea impedir que un subproceso realice un cambio en la información de enlace por un subproceso afecte a la información de enlace utilizada por otros subprocesos.

Una vez que una aplicación llama a RpcBindingCopy, las operaciones realizadas en el identificador de enlace SourceBinding no afectan a la información de enlace a la que hace referencia el identificador de enlace DestinationBinding . Del mismo modo, las operaciones realizadas en el identificador de enlace DestinationBinding no afectan a la información de enlace a la que hace referencia el identificador de enlace SourceBinding .

Si una aplicación quiere que los cambios de un subproceso en la información de enlace afecten a la información de enlace utilizada por otros subprocesos, la aplicación debe compartir un único identificador de enlace entre los subprocesos. En este caso, la aplicación es responsable del control de simultaneidad de identificador de enlace.

Cuando una aplicación termina de usar el identificador de enlace especificado por el parámetro DestinationBinding , la aplicación debe llamar a la función RpcBindingFree para liberar la memoria utilizada por el identificador de enlace DestinationBinding y su información de enlace a la que se hace referencia.

Nota Microsoft RPC solo admite RpcBindingCopy en aplicaciones cliente, no en aplicaciones de servidor.
 

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows 2000 Server [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado rpcdce.h (incluir Rpc.h)
Library Rpcrt4.lib
Archivo DLL Rpcrt4.dll

Consulte también

RpcBindingFree