RpcMgmtEpUnregister-Funktion (rpcdce.h)

Artikel
03/01/2024

[Diese Funktion wird nur unter Windows NT und Windows Me/98/95 unterstützt. Sie gibt EP_S_CANT_PERFORM_OP für andere Versionen von Windows zurück.]

Die RpcMgmtEpUnregister-Funktion entfernt Serveradresseninformationen aus einer Endpunktzuordnung.

Syntax

RPC_STATUS RpcMgmtEpUnregister(
  RPC_BINDING_HANDLE EpBinding,
  RPC_IF_ID          *IfId,
  RPC_BINDING_HANDLE Binding,
  UUID               *ObjectUuid
);

Parameter

EpBinding

Host, dessen Endpunktzuordnungselemente die Registrierung aufheben sollen. Um Elemente vom gleichen Host wie die aufrufende Anwendung zu entfernen, gibt die Anwendung den Wert NULL an. Um Elemente von einem anderen Host zu entfernen, gibt die Anwendung ein Serverbindungshandle für jeden Server an, der sich auf diesem Host befindet. Beachten Sie, dass die Anwendung dasselbe Bindungshandle angeben kann, das sie auch für andere Remoteprozeduraufrufe verwendet.

IfId

Schnittstellenbezeichner, der aus der Endpunktzuordnung entfernt werden soll.

Binding

Zu entfernende Bindungshandle.

ObjectUuid

Optionale Zu entfernende Objekt-UUID. Der Wert NULL gibt an, dass keine Zu entfernende Objekt-UUID vorhanden ist.

Rückgabewert

Rückgabecode	Beschreibung
RPC_S_OK	Der Aufruf war erfolgreich.
RPC_S_CANT_PERFORM_OP	Der angeforderte Vorgang kann nicht ausgeführt werden.

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

Hinweise

Die RpcMgmtEpUnregister-Funktion hebt die Registrierung eines Elements in der Endpunktzuordnung auf. Ein Verwaltungsprogramm ruft diese Funktion auf, um Adressen von Servern zu entfernen, die nicht mehr verfügbar sind, oder um Adressen von Servern zu entfernen, die nicht mehr angebotene Objekte unterstützen.

Der EpBinding-Parameter muss eine vollständige Bindung sein. Die dem EpBinding-Parameter zugeordnete Objekt-UUID muss eine Null-UUID sein. Wenn Sie eine Nicht-Null-UUID angeben, schlägt die Funktion mit dem status Code EPT_S_CANT_PERFORM_OP fehl. Mit Ausnahme der Hostinformationen und der Objekt-UUID werden alle Informationen in diesem Argument ignoriert.

Eine Anwendung ruft RpcMgmtEpEltInqNext auf, um lokale Endpunktzuordnungselemente anzuzeigen. Die Anwendung kann dann die Elemente mithilfe von RpcMgmtEpUnregister entfernen.

Hinweis Verwenden Sie diese Funktion mit Vorsicht. Das Entfernen von Elementen aus der lokalen Endpunktzuordnung kann dazu führen, dass Server für Clientanwendungen nicht verfügbar sind, die nicht bereits über ein vollständig gebundenes Bindungshandle an den Server verfügen.