RpcEpRegisterA-Funktion (rpcdce.h)

Die RpcEpRegister-Funktion fügt Serveradresseninformationen in der lokalen Endpunktzuordnungsdatenbank hinzu oder ersetzt sie.

Syntax

RPC_STATUS RpcEpRegisterA(
  RPC_IF_HANDLE      IfSpec,
  RPC_BINDING_VECTOR *BindingVector,
  UUID_VECTOR        *UuidVector,
  RPC_CSTR           Annotation
);

Parameter

IfSpec

Schnittstelle zum Registrieren bei der lokalen Endpunktzuordnungsdatenbank.

BindingVector

Zeiger auf einen Bindungsvektor, über den der Server Remoteprozeduraufrufe empfangen kann.

UuidVector

Zeiger auf einen Vektor von Objekt-UUIDs, die vom Server angeboten werden. Die Serveranwendung erstellt diesen Vektor. Ein Null-Argumentwert gibt an, dass keine Objekt-UUIDs registriert werden müssen.

Annotation

Zeiger auf den Zeichenzeichenfolgenkommentar, der auf jedes produktübergreifende Element angewendet wird, das der lokalen Endpunktzuordnungsdatenbank hinzugefügt wurde. Die Zeichenfolge kann bis zu 64 Zeichen lang sein, einschließlich des Null-Endzeichens. Geben Sie einen NULL-Wert oder eine mit Null beendete Zeichenfolge ("\0") an, wenn keine Anmerkungszeichenfolge vorhanden ist.

Die Anmerkungszeichenfolge wird nur von Anwendungen für Informationen verwendet. RPC verwendet diese Zeichenfolge nicht, um zu bestimmen, mit welcher Serverinstanz ein Client kommuniziert, oder um Elemente in der Endpunktzuordnungsdatenbank aufzulisten.

Rückgabewert

Bemerkungen

Die funktion RpcEpRegister fügt Einträge in der Endpunktzuordnungsdatenbank des lokalen Hosts hinzu oder ersetzt sie. Bei einem vorhandenen Datenbankeintrag, der der bereitgestellten Schnittstellenspezifikation, dem Bindungshandle und objekt-UUID entspricht, ersetzt diese Funktion den Endpunkt des Eintrags durch den Endpunkt im bereitgestellten Bindungshandle.

Ein Server kann RpcEpRegister- und RpcEpRegisterNoReplace- verwenden, um Einträge in der Endpunktzuordnungsdatenbank zu registrieren. Vor Windows 2000 waren zwei Funktionen verfügbar, um einem Server das Überschreiben veralteter Einträge in der Endpunktzuordnungsdatenbank aus früheren Serverinstanzen zu ermöglichen, die nicht mehr ausgeführt werden. Die Endpunktzuordnungsdatenbank entfernt Einträge, die von einer Serverinstanz registriert wurden, automatisch, sobald der Server nicht mehr funktioniert. Server dürfen die Endpunktzuordnungseinträge eines anderen Servers jedoch nicht für Sicherheitszwecke ersetzen. Daher führen rpcEpRegister und RpcEpRegisterNoReplace weitgehend die gleichen Funktionen aus.

Eine Serveranwendung ruft RpcEpRegister- auf, um durch Aufrufen einer der folgenden Funktionen angegebene Endpunkte zu registrieren:

• RpcServerUseAllProtseqs
• RpcServerUseProtseq-
• RpcServerUseProtseqEp-
• RpcServerUseAllProtseqsIf
• RpcServerUseProtseqIf-

Wenn eine Protokollsequenz ohne Angabe eines Endpunkts verwendet wird, generiert die RPC-Laufzeitbibliothek automatisch einen dynamischen Endpunkt.If a protocol sequence is used without specifying an endpoint, the RPC run-time library automatically generates a dynamic endpoint.. In diesem Fall kann der Server RpcServerInqBindings gefolgt von RpcEpRegister- aufrufen, um sich für mehrere Clients zur Verfügung zu stellen. Andernfalls ist der automatisch gestartete Server nur für den Client bekannt, für den der Server gestartet wurde. Jedes Element, das der Endpunktzuordnungsdatenbank hinzugefügt wurde, enthält logisch Folgendes:

• Schnittstelle UUID-
• Schnittstellenversion (Haupt- und Nebenversion)
• Bindungshandle
• Objekt UUID (optional)
• Anmerkung (optional)

Anforderungen

Siehe auch

RpcBindingFromStringBinding

RpcEpRegisterNoReplace-

rpcEpUnregister-

RpcNsBindingExport-

rpcServerInqBindings-

RpcServerUseAllProtseqs

RpcServerUseAllProtseqsIf

RpcServerUseProtseq-

RpcServerUseProtseqEp-

RpcServerUseProtseqIf-