Função RpcBindingCopy (rpcdce.h)

  • Artigo

A função RpcBindingCopy copia informações de associação e cria um novo identificador de associação.

Sintaxe

RPC_STATUS RpcBindingCopy(
  RPC_BINDING_HANDLE SourceBinding,
  RPC_BINDING_HANDLE *DestinationBinding
);

Parâmetros

SourceBinding

Identificador de associação de servidor cujas informações de associação referenciadas são copiadas.

DestinationBinding

Retorna um ponteiro para o identificador de associação do servidor que se refere às informações de associação copiadas.

Valor retornado

Valor Significado
RPC_S_OK
 A chamada foi bem-sucedida.
RPC_S_INVALID_BINDING
 O identificador de associação era inválido.
RPC_S_WRONG_KIND_OF_BINDING
 Esse foi o tipo errado de associação para a operação.
 
Nota Para obter uma lista de códigos de erro válidos, consulte RPC Return Values.
 

Comentários

A função RpcBindingCopy copia as informações de associação de servidor referenciadas pelo parâmetro SourceBinding . RpcBindingCopy usa o parâmetro DestinationBinding para retornar um novo identificador de associação de servidor para as informações de associação copiadas. RpcBindingCopy também copia as informações de autenticação do parâmetro SourceBinding para o parâmetro DestinationBinding .

Um aplicativo usa RpcBindingCopy quando deseja impedir que uma alteração feita nas informações de associação por um thread afete as informações de associação usadas por outros threads.

Depois que um aplicativo chama RpcBindingCopy, as operações executadas no identificador de associação SourceBinding não afetam as informações de associação referenciadas pelo identificador de associação DestinationBinding . Da mesma forma, as operações executadas no identificador de associação DestinationBinding não afetam as informações de associação referenciadas pelo identificador de associação SourceBinding .

Se um aplicativo quiser que as alterações de um thread nas informações de associação afetem as informações de associação usadas por outros threads, o aplicativo deverá compartilhar um único identificador de associação entre os threads. Nesse caso, o aplicativo é responsável pelo controle de simultaneidade do identificador de associação.

Quando um aplicativo for concluído usando o identificador de associação especificado pelo parâmetro DestinationBinding , o aplicativo deverá chamar a função RpcBindingFree para liberar a memória usada pelo identificador de associação DestinationBinding e suas informações de associação referenciadas.

Nota O Microsoft RPC dá suporte a RpcBindingCopy somente em aplicativos cliente, não em aplicativos de servidor.
 

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho rpcdce.h (inclua Rpc.h)
Biblioteca Rpcrt4.lib
DLL Rpcrt4.dll

Confira também

RpcBindingFree