RpcMgmtSetComTimeout-Funktion (rpcdce.h)

Artikel
08/25/2023

Die RpcMgmtSetComTimeout-Funktion legt den Timeoutwert für Bindungskommunikation in einem Bindungshandle fest.

Syntax

RPC_STATUS RpcMgmtSetComTimeout(
  RPC_BINDING_HANDLE Binding,
  unsigned int       Timeout
);

Parameter

Binding

Serverbindungshandle, dessen Timeoutwert festgelegt ist.

Timeout

Kommunikationstimeoutwert von 0 bis 10. Diese Werte sind keine Sekunden; sie stellen eine relative Zeitspanne auf einer Skala von 0 bis 10 dar.

Rückgabewert

Wert	Bedeutung
RPC_S_OK	Der Aufruf war erfolgreich.
RPC_S_INVALID_BINDING	Das Bindungshandle war ungültig.
RPC_S_INVALID_TIMEOUT	Der Timeoutwert war ungültig.
RPC_S_WRONG_KIND_OF_BINDING	Dies war die falsche Art der Bindung für den Vorgang.

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

Hinweise

In Windows XP und Windows 2000 verwendet die RPC-Laufzeit während der Bindung das kürzere Timeout eines Aufrufs von 15 Minuten und den Timeoutsatz mithilfe der RpcMgmtSetComTimeout-Funktion . In Austauschvorgängen nach der Bindung verwendet die RPC-Laufzeit nur das timeout, das mit der RpcMgmtSetComTimeout-Funktion festgelegt wurde. Diese Option wird für ncalrpc - und ncadg_* -Protokollsequenzen ignoriert.

Eine Clientanwendung ruft RpcMgmtSetComTimeout auf, um den Timeoutwert für die Kommunikation für ein Serverbindungshandle zu ändern. Abhängig von der Protokollsequenz für das angegebene Bindungshandle fungiert der Timeoutwert nur als Hinweis auf die RPC-Laufzeitbibliothek. Jede Protokollsequenz interpretiert diese Einstellung unterschiedlich. für ncacn_ip_tcp wird der Wert verwendet, um Keep-Alives für alle Aufrufe zu aktivieren. Wenn Sie z. B. für ncacn_ip_tcpTimeout auf 0 festlegen, wird RPC angewiesen, Keep-Alives zu aktivieren, wenn eine Antwort nicht in 60 Sekunden empfangen wird (das 60-Sekunden-Intervall ist implementierungsspezifisch und kann geändert werden). In diesem Fall wird für den Clientaufruf kein Timeout ausgeführt, solange der Server ausgeführt wird. Wenn der Server jedoch ausfällt oder seine IP-Adresse verliert, schlägt RPC den Aufruf fehl. Der TCP-Timeouthinweis wird sowohl beim Verbindungsaufbau als auch beim Austausch von Anforderung/Antwort verwendet.

Hinweis Die Verwendung des TCP-Timeouthinweises ist die bewährte Methode zum Erkennen fehlerhafter Server.

In Windows XP werden Keep-Alives für eine bestimmte Verbindung deaktiviert, wenn der Server antwortet.

Der Einfachheit halber werden Konstanten für bestimmte Werte im Timeoutbereich bereitgestellt. Eine Liste der RPC-definierten Werte, die eine Anwendung für das Timeoutargument verwenden kann, finden Sie unter Bindungstimeoutkonstanten.

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	rpcdce.h (rpc.h einschließen)
Bibliothek	Rpcrt4.lib
DLL	Rpcrt4.dll

Weitere Informationen

RpcMgmtInqComTimeout

Share via