RpcMgmtEpEltInqNextA, fonction (rpcdce.h)
La fonction RpcMgmtEpEltInqNext retourne un élément à partir d’un mappage 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 d’enquête. Le contexte d’enquête est retourné par RpcMgmtEpEltInqBegin.
IfId
Retourne l’identificateur d’interface de l’élément endpoint-map.
Binding
Optionnel. Retourne le handle de liaison à partir de l’élément endpoint-map.
ObjectUuid
Optionnel. Retourne l’UUID de l’objet à partir de l’élément endpoint-map.
Annotation
Optionnel. Retourne la chaîne d’annotation de 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 de retour
| Valeur | Signification |
|---|---|
|
L’appel a réussi. |
Remarques
La fonction RpcMgmtEpEltInqNext retourne un élément du mappage de point de terminaison. Les éléments sélectionnés dépendent du contexte d’enquête. Les critères de sélection sont déterminés par de la fonction RpcMgmtEpEltInqBegin qui a retourné 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 un état RPC_X_NO_MORE_ENTRIES. 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 liaison et annotation sur chaque appel à cette fonction. L’application est chargée d’appeler
Après avoir consulté les éléments de mappage de point de terminaison, l’application doit appeler RpcMgmtEpEltInqDone pour supprimer le contexte d’enquête.
Note
L’en-tête rpcdce.h définit RpcMgmtEpEltInqNext comme 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| plateforme cible | Windows |
| d’en-tête | rpcdce.h (inclure Rpc.h) |
| bibliothèque | Rpcrt4.lib |
| DLL | Rpcrt4.dll |