RpcNsBindingExportPnPW-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.
Syntax
RPC_STATUS RpcNsBindingExportPnPW(
unsigned long EntryNameSyntax,
RPC_WSTR 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, auf den Bindungshandles und Objekt-UUIDs exportiert werden. Sie können keine NULL- oder leere Zeichenfolge angeben.
Um den im Registrierungswerteintrag HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultEntryangegebenen Eintragsnamen zu 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 keine Bindungshandles zum Exportieren vorhanden sind (nur Objekt-UUIDs werden exportiert), 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 zum Exportieren vorhanden sind (nur Bindungshandles werden exportiert).
Rückgabewert
Wert | Bedeutung |
---|---|
|
Der Aufruf war erfolgreich. |
|
Es gab nichts zu exportieren. |
|
Das Bindungshandle war ungültig. |
|
Dies war die falsche Art der 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 name-service-Vorgang. |
|
Der Namensdienst ist nicht verfügbar. |
Hinweise
Die RpcNsBindingExportPnP-Funktion ermöglicht es einer Serveranwendung, öffentlich eine Schnittstelle in der Name-Dienst-Datenbank anzubieten, die Plug-and-Play-Bindungen für die Verwendung durch jede Clientanwendung unterstützt.
Beachten Sie, dass die Serveranwendung den Bindungsvektor beim Exportieren von Plug-and-Play-Bindungen nicht explizit angeben 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 automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code 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 (include Rpc.h) |
Bibliothek | Rpcns4.lib |
DLL | Rpcns4.dll |
Weitere Informationen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für