RPC_ENDPOINT_TEMPLATEA Struktur (rpcdce.h)
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_TEMPLATEA, *PRPC_ENDPOINT_TEMPLATEA;
Angehörige
Version
Dieses Feld ist reserviert und muss auf 0 festgelegt werden.
ProtSeq
Zeigen Sie auf einen Zeichenfolgenbezeichner der Protokollsequenz, um sie bei der RPC-Laufzeitbibliothek zu registrieren. Es werden nur ncalrpc, ncacn_ip_tcp und ncacn_np 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 auf dem Endpunkt, um eine Serversicherheit zu gewährleisten, wird nicht empfohlen.
Backlog
Länge der Backlogwarteschlange 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 in den Hinweisen.
Bemerkungen
Der in Backlog- von Anwendungen bereitgestellte Wert ist nur ein Hinweis. Die RPC-Laufzeit oder der Windows Sockets-Anbieter überschreiben möglicherweise den Wert. Beispielsweise ist der Wert unter Windows XP oder Windows 2000 Professional 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 vorsichtig sein, um angemessene Werte in Backlog-zu übergeben. Große Werte auf Server, Advanced Server oder Datacenter Server können dazu führen, dass eine große Menge nicht ausgelagerter Poolspeicher verwendet wird. Die Verwendung eines zu kleinen Werts ist auch ungünstig, da es dazu führen kann, dass TCP SYN-Pakete von TCP RST vom Server erfüllt werden, wenn die Backlogwarteschlange erschöpft wird.
Ein Anwendungsentwickler sollte den Speicherbedarf gegenüber den Skalierbarkeitsanforderungen ausgleichen, wenn der richtige Wert für Backlog-ermittelt wird.
Anmerkung
Der rpcdce.h-Header definiert RPC_ENDPOINT_TEMPLATE als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 8 [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows Server 2012 [nur Desktop-Apps] |
| Header- | rpcdce.h (include Rpc.h) |