Fonction RpcMgmtEpUnregister (rpcdce.h)

Article
03/04/2024

[Cette fonction est prise en charge uniquement sur Windows NT et Windows Me/98/95 ; elle retourne EP_S_CANT_PERFORM_OP sur les autres versions de Windows.]

La fonction RpcMgmtEpUnregister supprime les informations d’adresse du serveur d’une carte de point de terminaison.

Syntaxe

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

Paramètres

EpBinding

Hôte dont les éléments endpoint-map doivent être désinscrits. Pour supprimer des éléments du même hôte que l’application appelante, l’application spécifie une valeur NULL. Pour supprimer des éléments d’un autre hôte, l’application spécifie un handle de liaison de serveur pour tout serveur résidant sur cet hôte. Notez que l’application peut spécifier le même handle de liaison qu’elle utilise pour effectuer d’autres appels de procédure distante.

IfId

Identificateur d’interface à supprimer de la carte de point de terminaison.

Binding

Handle de liaison à supprimer.

ObjectUuid

UUID d’objet facultatif à supprimer. La valeur NULL indique qu’il n’y a pas d’UUID d’objet à supprimer.

Valeur retournée

Code de retour	Description
RPC_S_OK	L’appel a réussi.
RPC_S_CANT_PERFORM_OP	Impossible d’effectuer l’opération demandée.

Note Pour obtenir la liste des codes d’erreur valides, consultez Valeurs de retour RPC.

Remarques

La fonction RpcMgmtEpUnregister annule l’inscription d’un élément de la carte de point de terminaison. Un programme de gestion appelle cette fonction pour supprimer les adresses des serveurs qui ne sont plus disponibles, ou pour supprimer les adresses des serveurs qui prennent en charge les objets qui ne sont plus proposés.

Le paramètre EpBinding doit être une liaison complète. L’UUID de l’objet associé au paramètre EpBinding doit être un UUID nul. La spécification d’un UUID non nul entraîne l’échec de la fonction avec le code status EPT_S_CANT_PERFORM_OP. En plus de l’UUID d’objet et des informations sur l’hôte, toutes les informations contenues dans cet argument sont ignorées.

Une application appelle RpcMgmtEpEltInqNext pour afficher les éléments de carte de point de terminaison locaux. L’application peut ensuite supprimer les éléments à l’aide de RpcMgmtEpUnregister.

Note Utilisez cette fonction avec précaution. La suppression d’éléments du mappage de point de terminaison local peut rendre les serveurs indisponibles pour les applications clientes qui ne disposent pas déjà d’un handle de liaison entièrement lié au serveur.