RPC_ENDPOINT_TEMPLATE-Struktur (rpcdce.h)

Artikel
08/25/2023

Die RPC_ENDPOINT_TEMPLATE-Struktur gibt die Eigenschaften eines RPC-Schnittstellengruppenserverendpunkts an, einschließlich Protokollsequenz und Name.

Syntax

typedef struct {
  unsigned long Version;
  RPC_CSTR      ProtSeq;
  RPC_CSTR      Endpoint;
  void          *SecurityDescriptor;
  unsigned long Backlog;
} RPC_ENDPOINT_TEMPLATE, *PRPC_ENDPOINT_TEMPLATE;

Member

Version

Dieses Feld ist reserviert und muss auf 0 festgelegt werden.

ProtSeq

Zeiger auf einen Zeichenfolgenbezeichner der Protokollsequenz, um sich bei der RPC-Laufzeitbibliothek zu registrieren. Nur ncalrpc, ncacn_ip_tcp und ncacn_np werden unterstützt. Dieser Wert darf nicht NULL sein.

Endpoint

Optionaler Zeiger auf die Endpunktadresseninformationen, die beim Erstellen einer Bindung für die im Protseq-Parameter angegebene Protokollsequenz verwendet werden sollen. Geben Sie NULL an, um dynamische Endpunkte zu verwenden.

SecurityDescriptor

Zeiger auf einen optionalen Parameter, der für das Sicherheitssubsystem bereitgestellt wird. Wird nur für ncacn_np - und ncalrPC-Protokollsequenzen verwendet. Alle anderen Protokollsequenzen ignorieren diesen Parameter. Die Verwendung eines Sicherheitsdeskriptors für den Endpunkt, um einen Server zu schützen, wird nicht empfohlen.

Backlog

Backlogwarteschlangenlänge für die ncacn_ip_tcp Protokollsequenz. Alle anderen Protokollsequenzen ignorieren diesen Parameter. Verwenden Sie RPC_C_PROTSEQ_MAX_REQS_DEFAULT , um den Standardwert anzugeben. Weitere Informationen finden Sie unter Hinweise.

Hinweise

Der im Backlog von Anwendungen bereitgestellte Wert ist nur ein Hinweis. Die RPC-Laufzeit oder der Windows Sockets-Anbieter überschreiben den Wert möglicherweise. Unter Windows XP oder Windows 2000 Professional ist der Wert beispielsweise auf 5 beschränkt. Werte, die größer als 5 sind, werden ignoriert, und stattdessen wird 5 verwendet. Unter Windows Server 2003 und Windows 2000 Server wird der Wert berücksichtigt.

Anwendungen müssen darauf achten, vernünftige Werte im Backlog zu übergeben. Große Werte auf Server, Advanced Server oder Datacenter Server können dazu führen, dass eine große Menge an nicht ausgelagertem Poolspeicher verwendet wird. Die Verwendung eines zu kleinen Werts ist ebenfalls ungünstig, da dies dazu führen kann, dass TCP SYN-Pakete von TCP RST vom Server erfüllt werden, wenn die Backlogwarteschlange erschöpft ist.

Ein Anwendungsentwickler sollte bei der Ermittlung des richtigen Werts für backlog zwischen Arbeitsspeicherbedarf und Skalierbarkeitsanforderungen abwägen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Kopfzeile	rpcdce.h (include Rpc.h)

Weitere Informationen

RpcServerInqBindings

Freigeben über