Bindungsoptionskonstanten

Anwendungen legen die Bindungsoptionskonstanten fest, um zu steuern, wie die RPC-Laufzeitbibliothek Remoteprozeduraufrufe verarbeitet. In der folgenden Tabelle werden jede Bindungseigenschaft und die relevanten konstanten Werte für die Bindungseigenschaften aufgelistet.

Hinweis

Alle Nachrichtenwarteschlangenoptionen (MQ) in der folgenden Tabelle sind nur für Windows 2000 gültig. Windows XP und höhere Versionen unterstützen message queuing nicht. Entwicklern wird davon abgeraten, Message Queuing zu verwenden.

Konstante/Wert BESCHREIBUNG
RPC _ C _ OPT _ BINDING _ NONCAUSAL
9
Standard. False gibt an, dass die Reihenfolge der ursächlichen Aufrufe erfolgt. RPC-Aufrufe werden in strenger Reihenfolge der Übermittlung ausgeführt. Siehe Hinweise.
True gibt an, dass die Reihenfolge der nichtcausalen Aufrufe nicht ist. RPC-Aufrufe werden unabhängig ausgeführt. Siehe Hinweise.
RPC _ C _ OPT _ MAX _ OPTIONS
17
Für Anwendungsprogramme nicht erforderlich. Wird intern von Microsoft verwendet.
RPC _ C _ DONT _ FAIL
4
Für Anwendungsprogramme nicht erforderlich. Wird intern von Microsoft verwendet.
RPC _ C _ OPT _ SESSION _ ID
6
True gibt an, dass für jede Verbindung eine Sitzungs-ID generiert wird.
RPC _ C _ OPT _ COOKIE _ AUTH
7
True gibt an, dass die clientseitige cookiebasierte Authentifizierung für Verbindungen verwendet wird. Ein Zeiger auf die RPC C OPT COOKIE _ _ _ _ AUTH _ DESCRIPTOR-Struktur wird als OptionValue-Parameter in RpcBindingSetOptionübergeben.
RPC _ C _ _ OPT-RESSOURCENTYP _ _ UUID
8
Für Anwendungsprogramme nicht erforderlich. Wird intern von Microsoft verwendet.
RPC _ C _ OPT _ DONT _ LINGER
13
True gibt an, dass das Herunterfahren der Zuordnung nach dem Freigeben des letzten Bindungshandle/Kontexthandle für die Zuordnung erzwingen wird.
RPC _ EINDEUTIGE C _ _ _ OPT-BINDUNG
11
Bei Festlegung auf TRUE werden vorhandene Verbindungen von RPC nicht wiederverwendet. Für jede Verbindung wird ein eindeutiges Bindungshandle geöffnet, und der Zustand wird für jedes eindeutige Bindungshandle beibehalten.

Hinweise

Standardmäßig führt die RPC-Laufzeitbibliothek die Aufrufe für ein bestimmtes Bindungshandle von jedem Thread einer Anwendung in strenger Reihenfolge der Übermittlung aus. Dies garantiert nicht, dass Aufrufe von verschiedenen Threads auf demselben Bindungshandle serialisiert werden. Multithreadanwendungen müssen ihre RPC-Aufrufe serialisieren. Wenn dieses Verhalten zu restriktiv ist, können Sie die nichtausale Sortierung aktivieren. Wenn Sie dies tun, führt die RPC-Laufzeitbibliothek Aufrufe unabhängig aus. Sie erzwingt keine Reihenfolge bei der Übermittlung.

Ein Beispiel für eine Anwendung, für die die nichtausale Sortierung nützlich sein kann, ist ein Multithreadprogramm, dessen Threads Aufrufe für dasselbe Bindungshandle vornehmen. Ebenso findet ein Programm, das mehrere asynchrone Aufrufe für ein Bindungshandle verwendet, eine praktische Option für die nichtausale Sortierung. Ein weiteres Beispiel ist ein Internetproxyprogramm, das einen einzelnen Thread verwendet, um Anforderungen für mehrere Clients zu verarbeiten. In jedem dieser Fälle wäre es äußerst restriktiv, die Remoteprozeduraufrufe zu serialisieren.

Die RPC C OPT _ _ _ DONT _ LINGER-Option kann nur für Bindungshandles festgelegt werden, die die Protokollsequenzen ncalrpc oder ncacn _ * _ verwenden. Sie kann nicht für __ * ncadg-Protokollsequenzen*_ verwendet werden. Die _RpcBindingSetOption-Funktion * mit dieser Option muss für ein Bindungshandle aufgerufen werden, für das mindestens ein RPC-Aufruf erfolgt ist. Wenn für das Bindungshandle kein RPC-Aufruf erfolgt ist, wird RPC S WRONG KIND OF _ _ _ _ _ BINDING vom RpcBindingSetOption-Funktionsaufruf zurückgegeben. Die Option wird für die gesamte Zuordnung wirksam, unabhängig davon, wie viele Bindungshandles an die Zuordnung angefügt sind. Da sie vor dem Zerstören der Zuordnung überprüft wird, kann sie jederzeit festgelegt werden, bevor das Bindungshandle geschlossen wird.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows 2000 Server [nur Desktop-Apps]
Header
Rpcdce.h;
Rpcdcep.h

Weitere Informationen

RpcBindingSetOption

RpcBindingInqOption

Verwalten von Netzwerkverbindungssätzen (Zuordnungen)