RpcServerInqBindingHandle-Funktion (rpcdce.h)

Die RpcServerInqBindingHandle-Funktion ruft das Bindungshandle für RPC-Aufrufe ab, die von dem Thread verwaltet werden, in dem RpcServerInqBindingHandle aufgerufen wird.

Syntax

RPC_STATUS RpcServerInqBindingHandle(
  RPC_BINDING_HANDLE *Binding
);

Parameter

Binding

RPC_BINDING_HANDLE Struktur, die bei Erfolg das Bindungshandle für den Aufruf empfängt, der von dem Thread verwaltet wird, für den RpcServerInqBindingHandle ebenfalls aufgerufen wird.

Wenn der Aufruf fehlschlägt, ist dieser Parameter nicht definiert.

Rückgabewert

Diese Funktion gibt bei Erfolg RPC_S_OK zurück. Andernfalls wird ein RPC_S_*-Fehlercode zurückgegeben. Diese Funktion kann nur dann fehlschlagen, wenn sie für einen Thread aufgerufen wird, der derzeit keinen RPC-Aufruf unterstützt.

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

 

Hinweise

RpcServerInqBindingHandle wird verwendet, um das Bindungshandle für den RPC-Aufruf abzurufen, der derzeit für den Thread ausgeführt wird, von dem diese API auch aufgerufen wird. Da viele RPC-APIs ein Bindungshandle als Eingabe erfordern, ist dies eine bequeme Möglichkeit, ein Bindungshandle abzurufen.

Beachten Sie, dass alle serverseitigen RPC-APIs, die ein Bindungshandle als Parameter verwenden, es Ihnen ermöglichen, NULL als akzeptierten Wert zu übergeben. Das Übergeben von NULL anstelle eines Bindungshandles gibt an, dass das Bindungshandle für den RPC-Aufruf verwendet werden soll, der derzeit im selben Thread ausgeführt wird. Wenn Sie jedoch eine serverseitige API aus einem separaten Thread aufrufen, müssen Sie ihnen ein Nicht-NULL-Bindungshandle bereitstellen.

Wenn Sie explizite Bindungshandles verwenden und keine threadspezifischen Kontexthandles verwenden, ist das Bindungshandle für den Aufruf der erste Parameter für Ihre Server-Manager-Routine. Wenn Sie jedoch keine expliziten Handles verwenden oder Kontexthandles verwenden, ist RpcServerInqBindingHandle die einzige Möglichkeit, ein Bindungshandle für die Verwendung in einem anderen Thread abzurufen.

Diese API kann sowohl für asynchrone als auch für synchrone Aufrufe verwendet werden, obwohl sie für asynchrone Aufrufe weniger nützlich ist, da das Bindungshandle abgerufen werden kann, da der asynchrone Zustand immer der erste Parameter für alle asynchronen RPC-Aufrufe ist und das Bindungshandle direkt mit RpcAsyncGetCallHandle abgerufen werden kann.

Anforderungen

Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	rpcdce.h (include Rpc.h)
Bibliothek	Rpcrt4.lib
DLL	Rpcrt4.dll

Weitere Informationen

RpcAsyncGetCallHandle