Fonction RpcMgmtEpUnregister (rpcdce.h)
[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 |
---|---|
|
L’appel a réussi. |
|
Impossible d’effectuer l’opération demandée. |
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.
Configuration requise
Condition requise | Valeur |
---|---|
Plateforme cible | Windows |
En-tête | rpcdce.h (inclure Rpc.h) |
Bibliothèque | Rpcrt4.lib |
DLL | Rpcrt4.dll |