RpcAsyncAbortCall-Funktion (rpcasync.h)

Artikel
08/25/2023

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
RPC_S_OK	Aufrufabbruch erfolgreich.
RPC_S_INVALID_ASYNC_HANDLE	Asynchrones Handle ist ungültig.

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

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