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 |
|---|---|
|
Der Aufruf war erfolgreich. |
|
Keine Bindungen. |
|
Das Bindungshandle war ungültig. |
|
Dies war die falsche Art der Bindung für den Vorgang. |
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 |