Funzione RpcBindingCopy (rpcdce.h)

Articolo
03/15/2023

La funzione RpcBindingCopy copia le informazioni di associazione e crea un nuovo handle di associazione.

Sintassi

RPC_STATUS RpcBindingCopy(
  RPC_BINDING_HANDLE SourceBinding,
  RPC_BINDING_HANDLE *DestinationBinding
);

Parametri

SourceBinding

Handle di associazione server le cui informazioni di associazione di riferimento vengono copiate.

DestinationBinding

Restituisce un puntatore all'handle di associazione server che fa riferimento alle informazioni di associazione copiate.

Valore restituito

Valore	Significato
RPC_S_OK	La chiamata ha avuto esito positivo.
RPC_S_INVALID_BINDING	Handle di associazione non valido.
RPC_S_WRONG_KIND_OF_BINDING	Si tratta del tipo di binding errato per l'operazione.

Nota Per un elenco di codici di errore validi, vedere Valori restituiti RPC.

Commenti

La funzione RpcBindingCopy copia le informazioni di associazione server a cui fa riferimento il parametro SourceBinding . RpcBindingCopy usa il parametro DestinationBinding per restituire un nuovo handle di associazione server per le informazioni di associazione copiate. RpcBindingCopy copia anche le informazioni di autenticazione dal parametro SourceBinding al parametro DestinationBinding .

Un'applicazione usa RpcBindingCopy quando vuole impedire che venga apportata una modifica alle informazioni di associazione da un thread che influiscano sulle informazioni di associazione usate da altri thread.

Quando un'applicazione chiama RpcBindingCopy, le operazioni eseguite sull'handle di associazione SourceBinding non influiscono sulle informazioni di associazione a cui fa riferimento l'handle di associazione DestinationBinding . Analogamente, le operazioni eseguite sull'handle di associazione DestinationBinding non influiscono sulle informazioni di associazione a cui fa riferimento l'handle di associazione SourceBinding .

Se un'applicazione vuole che le modifiche di un thread alle informazioni di associazione influiscano sulle informazioni di associazione usate da altri thread, l'applicazione deve condividere un singolo handle di associazione tra i thread. In questo caso, l'applicazione è responsabile del controllo della concorrenza dell'handle di associazione.

Al termine dell'utilizzo dell'handle di associazione specificato dal parametro DestinationBinding , l'applicazione deve chiamare la funzione RpcBindingFree per rilasciare la memoria utilizzata dall'handle di associazione DestinationBinding e le relative informazioni di associazione di riferimento.

Nota Rpc Microsoft supporta RpcBindingCopy solo nelle applicazioni client, non nelle applicazioni server.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [app desktop \| App UWP]
Server minimo supportato	Windows 2000 Server [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	rpcdce.h (include Rpc.h)
Libreria	Rpcrt4.lib
DLL	Rpcrt4.dll

Vedi anche

RpcBindingFree

Condividi tramite