Función RpcBindingCopy (rpcdce.h)
La función RpcBindingCopy copia la información de enlace y crea un nuevo identificador de enlace.
RPC_STATUS RpcBindingCopy(
RPC_BINDING_HANDLE SourceBinding,
RPC_BINDING_HANDLE *DestinationBinding
);
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 | Significado |
---|---|
|
La llamada se realizó correctamente. |
|
El identificador de enlace no era válido. |
|
Este era el tipo incorrecto de enlace para la operación. |
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.
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 |