Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |
|---|---|
|
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. |
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 |