RpcBindingCopy-Funktion (rpcdce.h)

  • Artikel

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

Wert Bedeutung
RPC_S_OK
 Der Aufruf war erfolgreich.
RPC_S_INVALID_BINDING
 Das Bindungshandle war ungültig.
RPC_S_WRONG_KIND_OF_BINDING
 Dies war die falsche Art der Bindung für den Vorgang.
 
Hinweis Eine Liste der gültigen Fehlercodes finden Sie unter RPC-Rückgabewerte.
 

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.

Hinweis Microsoft RPC unterstützt RpcBindingCopy nur in Clientanwendungen, nicht in Serveranwendungen.
 

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile rpcdce.h (include Rpc.h)
Bibliothek Rpcrt4.lib
DLL Rpcrt4.dll

Weitere Informationen

RpcBindingFree