Freigeben über


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
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

Weitere Informationen

Asynchroner RPC

RPC_ASYNC_STATE

RpcAsyncCancelCall

RpcAsyncCompleteCall

RpcAsyncGetCallHandle

RpcAsyncGetCallStatus

RpcAsyncInitializeHandle

RpcServerTestCancel