RpcNsBindingExportA-Funktion (rpcnsi.h)
Die funktion RpcNsBindingExport stellt einen Namensdienstdatenbankeintrag mit mehreren Bindungshandles und mehreren Objekten für einen Server her.
Syntax
RPC_STATUS RpcNsBindingExportA(
unsigned long EntryNameSyntax,
RPC_CSTR EntryName,
RPC_IF_HANDLE IfSpec,
RPC_BINDING_VECTOR *BindingVec,
UUID_VECTOR *ObjectUuidVec
);
Parameter
EntryNameSyntax
Syntax des EntryName-.
Um die im Registrierungswerteintrag HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntaxangegebene Syntax zu verwenden, geben Sie einen Wert von RPC_C_NS_SYNTAX_DEFAULT an.
EntryName
Zeiger auf den Eintragsnamen, in den Bindungshandles und Objekt-UUIDs exportiert werden. Sie können keine NULL- oder leere Zeichenfolge angeben. Der Client und der Server müssen beide denselben Eintragsnamen verwenden.
IfSpec
Stub-generierte Datenstruktur, die die zu exportierende Schnittstelle angibt. Ein NULL-Wert gibt an, dass es keine Bindungshandles zum Exportieren gibt (nur Objekt-UUIDs werden exportiert werden) und BindingVec- ignoriert wird.
BindingVec
Zeiger auf Serverbindungen, die exportiert werden sollen. Ein Nullwert gibt an, dass keine Bindungshandles zum Exportieren vorhanden sind (nur Objekt-UUIDs werden exportiert).
ObjectUuidVec
Zeiger auf einen Vektor von Objekt-UUIDs, die vom Server angeboten werden. Die Serveranwendung erstellt diesen Vektor. Ein Nullwert gibt an, dass keine Objekt-UUIDs zum Exportieren vorhanden sind (es werden nur Bindungshandles exportiert).
Rückgabewert
| Wert | Bedeutung |
|---|---|
|
Der Aufruf war erfolgreich. |
|
Es gab nichts zu exportieren. |
|
Das Bindungshandle war ungültig. |
|
Dies war die falsche Art von Bindung für den Vorgang. |
|
Die Namenssyntax ist ungültig. |
|
Die Namenssyntax wird nicht unterstützt. |
|
Der Name ist unvollständig. |
|
Keine Berechtigung für den Namendienstvorgang. |
|
Der Namensdienst ist nicht verfügbar. |
Bemerkungen
Die RpcNsBindingExport--Funktion ermöglicht einer Serveranwendung, öffentlich eine Schnittstelle in der Namensdienstdatenbank für die Verwendung durch eine beliebige Clientanwendung anzubieten.
Ab Windows 2000 verwendet die RPC-Laufzeitumgebung active Directory als Name-Service-Datenbank. Dies bedeutet, dass autorisierte exportierte Einträge im Namensdienst beibehalten werden und auch nach dem Neustart sichtbar sind. Nicht autorisierte Exporte bleiben nicht erhalten. Weitere Informationen zu Autorisierungs- und Zugriffssteuerungslisten finden Sie im Abschnitt "Sicherheit" des Platform Software Development Kit (SDK).
Zum Exportieren einer Schnittstelle ruft die Serveranwendung die RpcNsBindingExport Routine mit einer Schnittstelle auf, und die Serverbindung verarbeitet einen Client für den Zugriff auf den Server. Eine Serveranwendung ruft auch die RpcNsBindingExport--Funktion auf, um das Objekt UUID(en) der ressource(n) öffentlich anzubieten, die(n) in der Namensdienstdatenbank(n) angeboten wird.
Ein Server kann Schnittstellen und Objekte in einem einzigen Aufruf von RpcNsBindingExport-exportieren oder separat exportieren. Wenn der durch EntryName- angegebene Name-Service-Datenbankeintrag nicht vorhanden ist, versucht RpcNsBindingExport- sie zu erstellen. In diesem Fall muss die Serveranwendung über die Berechtigung zum Erstellen des Eintrags verfügen. Zusätzlich zum Aufrufen RpcNsBindingExportmuss ein Server, der die RpcServerUseAllProtseqs oder RpcServerUseProtseq-Funktion auch bei der lokalen Endpunktzuordnungsdatenbank registrieren, indem entweder RpcEpRegister oder RpcEpRegisterNoReplace-aufgerufen wird.
Ein Server ist nicht erforderlich, um eine seiner Schnittstellen in die Name-Service-Datenbank zu exportieren. Wenn ein Server nicht exportiert wird, können nur Clients, die privat wissen, dass die Bindungsinformationen des Servers auf seine Schnittstellen zugreifen können. Beispielsweise kann ein Client, der über die zum Erstellen einer Zeichenfolgenbindung erforderlichen Informationen verfügt, die RpcBindingFromStringBinding- aufrufen, um ein Bindungshandle zum Erstellen von Remoteprozeduraufrufen an einen Server zu erstellen.
Vor dem Aufrufen RpcNsBindingExport-muss ein Server Folgendes ausführen:
- Registrieren Sie eine oder mehrere Protokollsequenzen mit der lokalen RPC-Laufzeitbibliothek, indem Sie eine der folgenden Funktionen aufrufen:
- Rufen Sie eine Liste der Serverbindungen ab, indem Sie die RpcServerInqBindings--Funktion aufrufen.
Wenn ein Server mehrmals in denselben Namensdienstdatenbankeintrag exportiert wird, fügen die zweiten und nachfolgenden Aufrufe von RpcNsBindingExport die Bindungsinformationen und Objekt-UUIDs hinzu, wenn sich diese Daten von den Bindungsinformationen unterscheiden, die sich bereits im Servereintrag befinden. Vorhandene Daten werden nicht aus dem Eintrag entfernt.
Um Bindungshandles und Objekt-UUIDs aus der Namensdienstdatenbank zu entfernen, ruft eine Serveranwendung die RpcNsBindingUnexport-Funktion auf.
Für einen Servereintrag muss mindestens ein Bindungshandle vorhanden sein. Daher hat das Exportieren nur UUIDs in einen nicht vorhandenen Eintrag keine Auswirkung, und das Aufheben des Exportierens aller Bindungshandles löscht den Eintrag.
Anmerkung
Der rpcnsi.h-Header definiert RpcNsBindingExport 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- | rpcnsi.h (include Rpc.h) |
| Library | Rpcns4.lib |
| DLL- | Rpcns4.dll |