RpcEpUnregister-Funktion (rpcdce.h)

Die RpcEpUnregister-Funktion entfernt Serveradresseninformationen aus der lokalen Endpunktzuordnungsdatenbank.

Syntax

RPC_STATUS RpcEpUnregister(
  RPC_IF_HANDLE      IfSpec,
  RPC_BINDING_VECTOR *BindingVector,
  UUID_VECTOR        *UuidVector
);

Parameter

IfSpec

Schnittstelle zum Aufheben der Registrierung in der lokalen Endpunktzuordnungsdatenbank.

BindingVector

Zeiger auf einen Vektor von Bindungshandles zum Aufheben der Registrierung.

UuidVector

Zeiger auf einen optionalen Vektor von Objekt-UUIDs zum Aufheben der Registrierung. Die Serveranwendung erstellt diesen Vektor. RpcEpUnregister hebt die Registrierung aller Endpunktzuordnungsdatenbankelemente auf, die den angegebenen IfSpec - und BindingVector-Parametern und den Objekt-UUID(n) entsprechen.

Ein NULL-Parameterwert gibt an, dass keine Objekt-UUIDs zum Aufheben der Registrierung vorhanden sind.

Rückgabewert

Wert	Bedeutung
RPC_S_OK	Der Aufruf war erfolgreich.
RPC_S_NO_BINDINGS	Keine Bindungen.
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.

 

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

 

Hinweise

Die RpcEpUnregister-Funktion entfernt Elemente aus der Endpunktzuordnungsdatenbank des lokalen Hosts. Eine Serveranwendung ruft diese Funktion nur auf, wenn der Server zuvor über registrierte Endpunkte verfügt und der Server diese Adressinformationen aus der Endpunktzuordnungsdatenbank entfernen möchte.

Insbesondere ermöglicht RpcEpUnregister einer Serveranwendung, ihre eigenen Endpunktzuordnungsdatenbankelemente (Serveradresseninformationen) basierend auf der Schnittstellenspezifikation oder sowohl auf der Schnittstellenspezifikation als auch auf den Objekt-UUID(n) der angebotenen Ressource(n) zu entfernen.

Der Server ruft die RpcServerInqBindings-Funktion auf, um den erforderlichen BindingVector-Parameter abzurufen. Um die Registrierung ausgewählter Endpunkte aufzuheben, kann der Server den Bindungsvektor vor dem Aufrufen dieser Funktion beschneiden.

RpcEpUnregister erstellt ein produktübergreifendes Element aus den Parametern IfSpec, BindingVector und UuidVector und entfernt jedes Element im cross-product aus der endpoint-map-Datenbank.

Anforderungen

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

Weitere Informationen

RpcEpRegister

RpcEpRegisterNoReplace

RpcNsBindingUnexport

RpcServerInqBindings