RpcNsBindingExportPnPA-Funktion (rpcnsi.h)

Artikel
11/20/2024

Die RpcNsBindingExportPnP--Funktion stellt einen Namensdienstdatenbankeintrag mit mehreren Bindungshandles und mehreren Objekten für einen Server her, der Plug and Play unterstützt.

Hinweis Diese Funktion wird unter Windows Vista und höheren Betriebssystemen nicht unterstützt.

Syntax

RPC_STATUS RpcNsBindingExportPnPA(
  unsigned long EntryNameSyntax,
  RPC_CSTR      EntryName,
  RPC_IF_HANDLE IfSpec,
  UUID_VECTOR   *ObjectVector
);

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.

Um den im Registrierungswerteintrag angegebenen Eintrag HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultEntryzu verwenden, geben Sie einen NULL-Zeiger oder eine leere Zeichenfolge an. In diesem Fall wird der EntryNameSyntax Parameter ignoriert, und die Laufzeitbibliothek verwendet die Standardsyntax.

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.

ObjectVector

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
RPC_S_OK	Der Aufruf war erfolgreich.
RPC_S_NOTHING_TO_EXPORT	Es gab nichts zu exportieren.
RPC_S_INVALID_BINDING	Das Bindungshandle war ungültig.
RPC_S_WRONG_KIND_OF_BINDING	Dies war die falsche Art von Bindung für den Vorgang.
RPC_S_INVALID_NAME_SYNTAX	Die Namenssyntax ist ungültig.
RPC_S_UNSUPPORTED_NAME_SYNTAX	Die Namenssyntax wird nicht unterstützt.
RPC_S_INCOMPLETE_NAME	Der Name ist unvollständig.
RPC_S_NO_NS_PRIVILEGE	Keine Berechtigung für den Namendienstvorgang.
RPC_S_NAME_SERVICE_UNAVAILABLE	Der Namensdienst ist nicht verfügbar.

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

Bemerkungen

Mit der RpcNsBindingExportPnP--Funktion kann eine Serveranwendung öffentlich eine Schnittstelle in der Namensdienstdatenbank anbieten, die Plug- und Play-Bindungen für die Verwendung durch jede Clientanwendung unterstützt.

Beachten Sie, dass die Serveranwendung beim Exportieren von Plug- und Play-Bindungen nicht explizit den Bindungsvektor bereitstellen sollte. Die Bindungen werden automatisch aktualisiert, wenn eine Änderung der Bindungen aufgrund eines Plug- und Play-Ereignisses erfolgt.

Anmerkung

Der rpcnsi.h-Header definiert RpcNsBindingExportPnP 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

Siehe auch

RpcNsBindingExport-

RpcNsBindingUnexportPnP-

Freigeben über