RpcMgmtSetCancelTimeout-Funktion (rpcdce.h)

  • Artikel

Die RpcMgmtSetCancelTimeout-Funktion legt die Untergrenze für die Wartezeit fest, bevor nach dem Weiterleiten eines Abbruchs ein Timeout ausgeführt wird.

Syntax

RPC_STATUS RpcMgmtSetCancelTimeout(
  long Timeout
);

Parameter

Timeout

Sekunden warten, bis ein Server einen Abbruchbefehl bestätigt. Um anzugeben, dass ein Client unbestimmte Zeit wartet, geben Sie den Wert RPC_C_CANCEL_INFINITE_TIMEOUT an.

Rückgabewert

Wert Bedeutung
RPC_S_OK
 Der Aufruf war erfolgreich.
RPC_S_CANNOT_SUPPORT
 Aufgerufen von einem MS-DOS oder Windows 3. x-Client .
 
Hinweis Eine Liste der gültigen Fehlercodes finden Sie unter RPC-Rückgabewerte.
 

Hinweise

Eine Anwendung ruft die RpcMgmtSetCancelTimeout-Funktion auf, um die Zeitspanne zurückzusetzen, die die Laufzeitbibliothek wartet, bis ein Server einen Abbruch bestätigt. Die Anwendung gibt an, entweder ewig zu warten oder eine bestimmte Zeit in Sekunden zu warten. Wenn der Wert von Seconds 0 (null) ist, wird der Aufruf sofort abgebrochen, wenn ein Befehl abbrechen und das Steuerelement an die Clientanwendung zurückgegeben wird. Der Standardwert ist RPC_C_CANCEL_INFINITE_TIMEOUT, der angibt, unbegrenzt auf den Abschluss des Aufrufs zu warten.

Der Wert für das Timeout des Cancel-Befehls gilt für alle Remoteprozeduraufrufe, die im aktuellen Thread ausgeführt werden. Um den Timeoutwert zu ändern, muss ein Multithreadclient diese Funktion in jedem Ausführungsthread aufrufen.

Anforderungen

Anforderung Wert
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 rpcdce.h (include Rpc.h)
Bibliothek Rpcrt4.lib
DLL Rpcrt4.dll