RpcBindingServerFromClient-Funktion (rpcdce.h)

Artikel
08/25/2023

Eine Anwendung ruft RpcBindingServerFromClient auf, um ein Clientbindungshandle in ein teilweise gebundenes Serverbindungshandle zu konvertieren.

Syntax

RPC_STATUS RpcBindingServerFromClient(
  RPC_BINDING_HANDLE ClientBinding,
  RPC_BINDING_HANDLE *ServerBinding
);

Parameter

ClientBinding

Clientbindungshandle zum Konvertieren in ein Serverbindungshandle. Wenn der Wert 0 (null) angegeben wird, gibt der Server die Identität des Clients an, der von diesem Serverthread bereitgestellt wird.

Hinweis Dieser Parameter darf in Windows NT 4.0 nicht NULL sein.

ServerBinding

Gibt ein Serverbindungshandle zurück.

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.
RPC_S_CANNOT_SUPPORT	Der Host des Clients kann nicht ermittelt werden. Eine Liste der unterstützten Protokollsequenzen finden Sie unter Hinweise.

Hinweis Eine Liste der gültigen Fehlercodes finden Sie unter RPC-Rückgabewerte.

Hinweise

Die folgenden Protokollsequenzen unterstützen RpcBindingServerFromClient:

Eine Anwendung ruft ein Clientbindungshandle aus der RPC-Laufzeit ab. Wenn der Remoteprozeduraufruf auf einem Server eingeht, erstellt die Laufzeit ein Clientbindungshandle, das Informationen zum aufrufenden Client enthält. Die Laufzeit übergibt dieses Handle als erstes Argument an die Server-Manager-Funktion.

Beim Aufrufen von RpcBindingServerFromClient wird dieses Clienthandle in ein Serverhandle konvertiert, das über die folgenden Eigenschaften verfügt:

Das Serverhandle ist ein teilweise gebundenes Handle. Es enthält eine Netzwerkadresse für den aufrufenden Client, aber es fehlt ein Endpunkt.
Das Serverhandle enthält die gleiche Objekt-UUID , die vom aufrufenden Client verwendet wird. Dies kann die null UUID sein. Weitere Informationen dazu, wie ein Client eine Objekt-UUID für einen Aufruf angibt, finden Sie unter RpcBindingsetObject, RpcNsBindingImportBegin, RpcNsBindingLookupBegin und RpcBindingFromStringBinding.
Das Serverhandle enthält keine Authentifizierungsinformationen.

Die Serveranwendung muss RpcBindingFree aufrufen, um die vom Serverbindungshandle verwendeten Ressourcen freizugeben, sobald es nicht mehr benötigt wird.

Hinweis Um die Adresse eines Clients abzufragen, ruft eine Anwendung zunächst die RpcBindingServerFromClient-Funktion auf, um ein teilweise gebundenes Serverbindungshandle abzurufen. Das Serverbindungshandle kann verwendet werden, um eine Zeichenfolgenbindung durch Aufrufen von RpcBindingToStringBinding abzurufen. Der Server kann dann RpcStringBindingParse aufrufen, um die Netzwerkadresse des Clients aus der Zeichenfolgenbindung zu extrahieren.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	rpcdce.h (rpc.h einschließen)
Bibliothek	Rpcrt4.lib
DLL	Rpcrt4.dll