RpcNsBindingUnexportPnPW-Funktion (rpcnsi.h)

Artikel
08/25/2023

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

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

Syntax

RPC_STATUS RpcNsBindingUnexportPnPW(
  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, aus 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, keine Bindungshandles aufzuheben (nur Objekt-UUIDs müssen nicht exportiert werden).

ObjectVector

Zeiger auf einen Vektor von Objekt-UUIDs, die der Server nicht mehr anbieten möchte. Die Anwendung erstellt diesen Vektor. Ein NULL-Wert gibt an, dass keine Objekt-UUIDs zum Aufheben des Exportes vorhanden sind (nur Bindungshandles dürfen nicht exportiert werden).

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-Dienst-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 der gültigen Fehlercodes finden Sie unter RPC-Rückgabewerte.

Hinweise

Mit der Funktion RpcNsBindingUnexportPnP kann eine Serveranwendung die Bindungshandles und Objekt-UUIDs von Plug and Play-kompatiblen Ressourcen aus einem Namensdienstdatenbankeintrag entfernen. Eine Serveranwendung kann die angegebene Schnittstelle und Objekte in einem einzelnen Aufruf von RpcNsBindingUnexportPnP aufheben oder sie separat aufheben. Nur die Bindungshandles, die mit der Schnittstellen-UUID und den Haupt- und Nebenschnittstellenversionsnummern im IfSpec-Parameter übereinstimmen, werden nicht exportiert.

Hinweis

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

RpcNsBindingExportPnPnP

RpcNsBindingUnexport

Share via