RpcAsyncAbortCall-Funktion (rpcasync.h)
Der Server ruft RpcAsyncAbortCall auf, um einen asynchronen Aufruf abzubrechen.
Syntax
RPC_STATUS RpcAsyncAbortCall(
PRPC_ASYNC_STATE pAsync,
unsigned long ExceptionCode
);
Parameter
pAsync
Zeiger auf die RPC_ASYNC_STATE Struktur, die asynchrone Aufrufinformationen enthält.
ExceptionCode
Ein anwendungsspezifischer Ausnahmecode ungleich Null. Dies kann ein anwendungsdefinierter Fehlercode oder ein standardmäßiger RPC-Fehlercode sein. Weitere Informationen finden Sie unter RPC-Rückgabewerte.
Rückgabewert
| Wert | Bedeutung |
|---|---|
|
Aufrufabbruch erfolgreich. |
|
Asynchrones Handle ist ungültig. |
Hinweise
Der Server ruft RpcAsyncAbortCall auf, wenn die Umstände erfordern, dass ein asynchroner Aufruf vor Abschluss abgebrochen werden muss. Beispielsweise verfügt der Aufrufer möglicherweise nicht über die erforderlichen Berechtigungen, um die Anforderung zu stellen, oder der Server ist möglicherweise zu beschäftigt, um den Aufruf zu verarbeiten. Verwenden Sie den ExceptionCode-Parameter , um den Grund für den Abbruch anzugeben. Die Laufzeitumgebung gibt den Ausnahmecode als Fehler an den Client weiter.
Wenn ein asynchroner Aufruf mit RpcAsyncAbortCall abgebrochen wird, wird kein Marshalling der Ausgabeargumente ausgeführt, und alle Eingabeargumente werden von RPC freigegeben. Wenn RpcAsyncAbortCall aufgerufen wird, ist kein Aufruf der RpcAsyncCompleteCall-Funktion erforderlich. Die RpcAsyncAbortCall-Funktion sollte für jeden asynchronen Aufruf nur einmal aufgerufen werden. Ein zweiter Aufruf kann den Prozess abstürzen oder auf andere unerwartete Weise fehlschlagen.
Anforderungen
| 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 | rpcasync.h (rpc.h einschließen) |
| Bibliothek | Rpcrt4.lib |
| DLL | Rpcrt4.dll |