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

Zeigen Sie auf die RPC_ASYNC_STATE Struktur, die asynchrone Anrufinformationen enthält.

ExceptionCode

Ein anwendungsspezifischer Ausnahmecode ohne Zero. Kann ein anwendungsdefinierter Fehlercode oder ein Standard-RPC-Fehlercode sein. Weitere Informationen finden Sie unter RPC-Rückgabewerte.

Rückgabewert

Wert Bedeutung
RPC_S_OK
Anrufabbruch erfolgreich.
RPC_S_INVALID_ASYNC_HANDLE
Asynchroner Handle ist ungültig.
 
Hinweis Eine Liste der gültigen Fehlercodes finden Sie unter RPC-Rückgabewerte.
 

Hinweise

Der Server ruft RpcAsyncAbortCall auf, wenn es erforderlich ist, einen asynchronen Aufruf vor Abschluss abzubrechen. Beispielsweise verfügt der Anrufer möglicherweise nicht über die erforderlichen Berechtigungen, um die Anforderung vorzunehmen, oder der Server kann zu beschäftigt sein, um den Anruf zu verarbeiten. Verwenden Sie den ExceptionCode-Parameter , um den Grund für den Abbruch anzugeben. Die Laufzeitumgebung verteilt den Ausnahmecode an den Client als Fehler.

Wenn ein asynchroner Aufruf mit RpcAsyncAbortCall abgebrochen wird, wird kein Marshal der Ausgabeargumente ausgeführt, und alle Eingabeargumente werden von RPC freigestellt. Wenn RpcAsyncAbortCall aufgerufen wird, ist ein Aufruf der RpcAsyncCompleteCall-Funktion nicht erforderlich. Die RpcAsyncAbortCall-Funktion sollte nur einmal für einen asynchronen Aufruf 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 (einschließlich Rpc.h)
Bibliothek Rpcrt4.lib
DLL Rpcrt4.dll

Weitere Informationen

Asynchrones RPC

RPC_ASYNC_STATE

RpcAsyncCancelCall

RpcAsyncCompleteCall

RpcAsyncGetCallHandle

RpcAsyncGetCallStatus

RpcAsyncInitializeHandle

RpcServerTestCancel