Fonction RpcMgmtEpEltInqNextA (rpcdce.h)
La fonction RpcMgmtEpEltInqNext retourne un élément à partir d’une carte de point de terminaison.
Syntaxe
RPC_STATUS RpcMgmtEpEltInqNextA(
RPC_EP_INQ_HANDLE InquiryContext,
RPC_IF_ID *IfId,
RPC_BINDING_HANDLE *Binding,
UUID *ObjectUuid,
RPC_CSTR *Annotation
);
Paramètres
InquiryContext
Spécifie un contexte de demande. Le contexte d’interrogation est retourné à partir de 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.
ObjectUuid
facultatif. Retourne l’UUID de l’objet à partir de l’élément endpoint-map.
Annotation
facultatif. Renvoie 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 |
|---|---|
|
L’appel a réussi. |
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 endpoint-map 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 ne sont pas 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 liaison 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.
Notes
L’en-tête rpcdce.h définit RpcMgmtEpEltInqNext comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
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 |