RpcServerUseProtseqIfA-Funktion (rpcdce.h)

Artikel
11/20/2024

Die funktion RpcServerUseProtseqIf weist die RPC-Laufzeitbibliothek an, die angegebene Protokollsequenz in Kombination mit den Endpunkten in der Schnittstellenspezifikation für den Empfang von Remoteprozeduraufrufen zu verwenden.

Syntax

RPC_STATUS RpcServerUseProtseqIfA(
  RPC_CSTR      Protseq,
  unsigned int  MaxCalls,
  RPC_IF_HANDLE IfSpec,
  void          *SecurityDescriptor
);

Parameter

Protseq

Zeigen Sie auf einen Zeichenfolgenbezeichner der Protokollsequenz, um sie bei der RPC-Laufzeitbibliothek zu registrieren.

MaxCalls

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. Siehe Anmerkungen.

IfSpec

Schnittstelle, die Endpunktinformationen enthält, die beim Erstellen einer Bindung für die im Protseq Parameter angegebene Protokollsequenz verwendet werden sollen.

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. Dieser Parameter wird in der DCE-Spezifikation für diese API nicht angezeigt.

Rückgabewert

Wert	Bedeutung
RPC_S_OK	Der Aufruf war erfolgreich.
RPC_S_PROTSEQ_NOT_FOUND	Der Endpunkt für diese Protokollsequenz wird in der IDL-Datei nicht angegeben.
RPC_S_PROTSEQ_NOT_SUPPORTED	Die Protokollsequenz wird auf diesem Host nicht unterstützt.
RPC_S_INVALID_RPC_PROTSEQ	Die Protokollsequenz ist ungültig.
RPC_S_INVALID_ENDPOINT_FORMAT	Das Endpunktformat ist ungültig.
RPC_S_OUT_OF_MEMORY	Das System ist nicht genügend Arbeitsspeicher.
RPC_S_INVALID_SECURITY_DESC	Der Sicherheitsdeskriptor ist ungültig.

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

Bemerkungen

Eine Serveranwendung ruft RpcServerUseProtseqIf- auf, um eine Protokollsequenz mit der RPC-Laufzeitbibliothek zu registrieren. Bei jeder Protokollsequenzregistrierung enthält die Routine die in der IDL-Datei bereitgestellten Endpunktadresseninformationen.

Um Remoteprozeduraufrufanforderungen zu empfangen, muss ein Server mindestens eine Protokollsequenz mit der RPC-Laufzeitbibliothek registrieren. Eine Serveranwendung kann diese Funktion mehrmals aufrufen, um zusätzliche Protokollsequenzen zu registrieren.

Für jede von einem Server registrierte Protokollsequenz erstellt die RPC-Laufzeitbibliothek einen oder mehrere Endpunkte, über die der Server Remoteprozeduraufrufanforderungen empfängt. Die RPC-Laufzeitbibliothek erstellt für jede Protokollsequenz unterschiedliche Endpunkte. Auf jede Schnittstelle im Prozess kann jedoch über einen beliebigen Endpunkt zugegriffen werden. Weitere Informationen finden Sie unter Schreiben eines sicheren RPC-Clients oder -Servers.

Für MaxCallsist der von der Anwendung bereitgestellte Wert 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 darauf achten, angemessene Werte in MaxCallszu ü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 im Vergleich zu den Skalierbarkeitsanforderungen ausgleichen, wenn der richtige Wert für MaxCalls-ermittelt wird.

Wenn der Computer für die Verwendung selektiver Bindung konfiguriert ist, garantiert die erfolgreiche Rückgabe nicht, dass der Server Endpunkte für alle Netzwerkschnittstellen erstellt hat, die auf dem Computer vorhanden sind. Die RPC-Laufzeit lauscht möglicherweise nicht auf einige Netzwerkschnittstellen, abhängig von den selektiven Bindungseinstellungen. Wenn eine Schnittstelle noch keine IP-Adresse mit DHCP empfangen hat, lauscht der RPC-Server erst dann auf der Netzwerkschnittstelle, wenn ihm eine DHCP-Adresse zugewiesen ist. Eine erfolgreiche Rückgabe bedeutet, dass der Server mindestens eine Netzwerkschnittstelle überwacht; die vollständige Liste der Bindungshandles, über die Remoteprozeduraufrufe empfangen werden können, kann mit einem Aufruf der RpcServerInqBindings-Funktion abgerufen werden.

Weitere Informationen finden Sie unter Server-Side Binding. Eine Liste der von Microsoft RPC unterstützten Protokollsequenzen finden Sie unter Zeichenfolgenbindung. Um alle Protokollsequenzen aus der IDL-Datei zu registrieren, ruft ein Server RpcServerUseAllProtseqsIfauf.

Hinweis Die Microsoft RPC-Implementierung von RpcServerUseProtseqIf enthält einen neuen, zusätzlichen Parameter, SecurityDescriptor, der nicht in der DCE-Spezifikation angezeigt wird.

Anmerkung

Der rpcdce.h-Header definiert RpcServerUseProtseqIf 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 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	rpcdce.h (include Rpc.h)
Library	Rpcrt4.lib
DLL-	Rpcrt4.dll