RpcNsBindingExportPnPA-Funktion (rpcnsi.h)

Die RpcNsBindingExportPnP-Funktion erstellt einen Name-Dienst-Datenbankeintrag mit mehreren Bindungshandles und mehreren Objekten für einen Server, 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 von EntryName.

Um die im Registrierungswerteintrag HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntaxangegebene Syntax zu verwenden, geben Sie den Wert 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 eintragsnamen zu verwenden, der im Registrierungswerteintrag HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultEntryangegeben ist, 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 keine Bindungshandles zu exportieren sind (nur Objekt-UUIDs müssen exportiert werden), und BindingVec wird ignoriert.

ObjectVector

Zeiger auf einen Vektor von Objekt-UUIDs, die vom Server angeboten werden. Die Serveranwendung erstellt diesen Vektor. Ein NULL-Wert gibt an, dass keine Objekt-UUIDs zu exportieren sind (nur Bindungshandles müssen exportiert werden).

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 der 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 Name-Service-Vorgänge.
RPC_S_NAME_SERVICE_UNAVAILABLE	Der Namensdienst ist nicht verfügbar.

 

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

 

Hinweise

Die RpcNsBindingExportPnP-Funktion ermöglicht es einer Serveranwendung, öffentlich eine Schnittstelle in der Name-Dienst-Datenbank anzubieten, die Plug-and-Play-Bindungen zur Verwendung durch jede Clientanwendung unterstützt.

Beachten Sie, dass die Serveranwendung den Bindungsvektor beim Exportieren von Plug-and-Play-Bindungen nicht explizit bereitstellen sollte. Die Bindungen werden automatisch aktualisiert, wenn sich die Bindungen aufgrund eines Plug-and-Play-Ereignisses ändern.

Hinweis

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

Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	rpcnsi.h (rpc.h einschließen)
Bibliothek	Rpcns4.lib
DLL	Rpcns4.dll

Weitere Informationen

RpcNsBindingExport

RpcNsBindingUnexportPnP