RpcBindingCopy-Funktion (rpcdce.h)

Die RpcBindingCopy-Funktion kopiert Bindungsinformationen und erstellt ein neues Bindungshandle.

Syntax

RPC_STATUS RpcBindingCopy(
  RPC_BINDING_HANDLE SourceBinding,
  RPC_BINDING_HANDLE *DestinationBinding
);

Parameter

SourceBinding

Serverbindungshandle, dessen Referenzbindungsinformationen kopiert werden.

DestinationBinding

Gibt einen Zeiger auf das Serverbindungshandle zurück, das auf die kopierten Bindungsinformationen verweist.

Rückgabewert

Hinweise

Die RpcBindingCopy-Funktion kopiert die Serverbindungsinformationen, auf die vom SourceBinding-Parameter verwiesen wird. RpcBindingCopy verwendet den Parameter DestinationBinding , um ein neues Serverbindungshandle für die kopierten Bindungsinformationen zurückzugeben. RpcBindingCopy kopiert auch die Authentifizierungsinformationen aus dem SourceBinding-Parameter in den Parameter DestinationBinding .

Eine Anwendung verwendet RpcBindingCopy , wenn sie verhindern möchte, dass sich eine Änderung an der Bindung von Informationen durch einen Thread auf die von anderen Threads verwendeten Bindungsinformationen auswirkt.

Sobald eine Anwendung RpcBindingCopy aufruft, wirken sich Vorgänge, die für das SourceBinding-Bindungshandle ausgeführt werden, nicht auf die Bindungsinformationen aus, auf die vom DestinationBinding-Bindungshandle verwiesen wird. Ebenso wirken sich Vorgänge, die für das DestinationBinding-Bindungshandle ausgeführt werden, nicht auf die Bindungsinformationen aus, auf die vom SourceBinding-Bindungshandle verwiesen wird.

Wenn eine Anwendung möchte, dass sich die Änderungen eines Threads an Bindungsinformationen auf die von anderen Threads verwendeten Bindungsinformationen auswirken, sollte die Anwendung ein einzelnes Bindungshandle für die Threads verwenden. In diesem Fall ist die Anwendung für die Parallelitätssteuerung für Bindungshandles verantwortlich.

Wenn eine Anwendung mit dem durch den Parameter DestinationBinding angegebenen Bindungshandle abgeschlossen wird, sollte die Anwendung die RpcBindingFree-Funktion aufrufen, um den vom DestinationBinding-Bindungshandle verwendeten Arbeitsspeicher und dessen Referenzbindungsinformationen freizugeben.

Anforderungen

Weitere Informationen

RpcBindingFree