RpcMgmtEpEltInqNext, fonction (rpcdce.h)

La fonction RpcMgmtEpEltInqNext retourne un élément à partir d’une carte de point de terminaison.

Syntaxe

RPC_STATUS RpcMgmtEpEltInqNext(
  RPC_EP_INQ_HANDLE  InquiryContext,
  RPC_IF_ID          *IfId,
  RPC_BINDING_HANDLE *Binding,
  RPC_CSTR           *Annotation
);

Paramètres

InquiryContext

Spécifie un contexte de recherche. Le contexte d’enquête est retourné par RpcMgmtEpEltInqBegin.

IfId

Retourne l’identificateur d’interface de l’élément endpoint-map.

Binding

facultatif. Retourne le handle de liaison à partir de l’élément endpoint-map.

Annotation

facultatif. Retourne la chaîne d’annotation pour l’élément endpoint-map. Lorsqu’il n’existe aucune chaîne d’annotation dans l’élément endpoint-map, la chaîne vide («  ») est retournée.

Valeur retournée

Valeur	Signification
RPC_S_OK	L’appel a réussi.

 

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

 

Remarques

La fonction RpcMgmtEpEltInqNext retourne un élément à partir de la carte de point de terminaison. Les éléments sélectionnés dépendent du contexte d’interrogation. Les critères de sélection sont déterminés par InquiryType de la fonction RpcMgmtEpEltInqBegin qui a renvoyé InquiryContext.

Une application peut afficher tous les éléments de mappage de point de terminaison sélectionnés en appelant à plusieurs reprises RpcMgmtEpEltInqNext. Lorsque tous les éléments ont été consultés, cette fonction retourne une RPC_X_NO_MORE_ENTRIES status. Les éléments retournés ne sont pas triés.

Lorsque les arguments respectifs n’ont pas la valeur NULL, la bibliothèque de fonctions d’exécution RPC alloue de la mémoire pour Binding et Annotation sur chaque appel à cette fonction. L’application est chargée d’appeler RpcBindingFree pour chaque binding retournée et RpcStringFree pour chaque annotation retournée.

Après avoir affiché les éléments endpoint-map, l’application doit appeler RpcMgmtEpEltInqDone pour supprimer le contexte d’interrogation.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	rpcdce.h (inclure Rpc.h)
Bibliothèque	Rpcrt4.lib
DLL	Rpcrt4.dll

Voir aussi

RpcEpRegister

RpcMgmtEpEltInqBegin

RpcMgmtEpEltInqDone