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
| Wert | Bedeutung |
|---|---|
|
Der Aufruf war erfolgreich. |
|
Das Bindungshandle war ungültig. |
|
Dies war die falsche Art der Bindung für den Vorgang. |
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
| 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 |