RpcNsBindingUnexportPnPA-Funktion (rpcnsi.h)

Artikel
11/20/2024

Die RpcNsBindingUnexportPnP--Funktion entfernt die Bindungshandles für Plug- und Play-Schnittstellen und -Objekte aus einem Eintrag in der Namensdienstdatenbank.

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

Syntax

RPC_STATUS RpcNsBindingUnexportPnPA(
  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

Zeigen Sie auf den Eintragsnamen, von dem Bindungshandles und Objekt-UUIDs entfernt werden sollen.

IfSpec

Schnittstellenspezifikation für die Bindungshandles, die aus der Namensdienstdatenbank entfernt werden sollen. Ein Null-Parameterwert gibt an, dass keine Bindungshandles nicht mehrexportiert werden sollen (nur Objekt-UUIDs sind nicht exportiert).

ObjectVector

Zeigen Sie auf einen Vektor von Objekt-UUIDs, die der Server nicht mehr anbieten möchte. Die Anwendung erstellt diesen Vektor. Ein Nullwert gibt an, dass keine Objekt-UUIDs zum Aufheben des Exports vorhanden sind (nur Bindungshandles sind nicht exportiert).

Rückgabewert

Wert	Bedeutung
RPC_S_OK	Der Aufruf war erfolgreich.
RPC_S_INVALID_VERS_OPTION	Die Versionsoption ist ungültig.
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_ENTRY_NOT_FOUND	Der Name-Service-Eintrag wurde nicht gefunden.
RPC_S_NAME_SERVICE_UNAVAILABLE	Der Namensdienst ist nicht verfügbar.
RPC_S_INTERFACE_NOT_FOUND	Die Schnittstelle wurde nicht gefunden.
RPC_S_NOT_ALL_OBJS_UNEXPORTED	Nicht alle Objekte werden nicht exportiert.

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

Bemerkungen

Mit der RpcNsBindingUnexportPnP--Funktion kann eine Serveranwendung die Bindungshandles und Objekt-UUIDs von Plug- und Play-kompatiblen Ressourcen aus einem Namensdienstdatenbankeintrag entfernen. Eine Serveranwendung kann die angegebene Schnittstelle und Objekte in einem einzigen Aufruf von RpcNsBindingUnexportPnP-aufheben oder diese separat aufheben. Nur die Bindungshandles, die mit der Schnittstelle UUID übereinstimmen, und die Haupt- und Nebenschnittstellennummern, die im IfSpec Parameter gefunden werden, werden nichtexportiert.

Anmerkung

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

RpcNsBindingExportPnP-

RpcNsBindingUnexport

Freigeben über