Fonction RpcNsEntryObjectInqNext (rpcnsi.h)

Article
03/01/2024

La fonction RpcNsEntryObjectInqNext retourne un objet à la fois à partir d’une entrée de base de données name-service.

Note Cette fonction n’est pas prise en charge sur Windows Vista et les systèmes d’exploitation ultérieurs.

Syntaxe

RPC_STATUS RpcNsEntryObjectInqNext(
  RPC_NS_HANDLE InquiryContext,
  UUID          *ObjUuid
);

Paramètres

InquiryContext

Handle de service de nom qui indique les UUID d’objet pour une entrée de base de données de service de nom.

ObjUuid

Retourne un pointeur vers un UUID d’objet exporté.

Valeur retournée

Valeur	Signification
RPC_S_OK	L’appel a réussi.
RPC_S_NO_MORE_MEMBERS	Plus de membres.
RPC_S_INCOMPLETE_NAME	Le nom est incomplet.
RPC_S_ENTRY_NOT_FOUND	L’entrée name-service est introuvable.
RPC_S_NAME_SERVICE_UNAVAILABLE	Nom de service indisponible.

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

Remarques

La fonction RpcNsEntryObjectInqNext retourne l’un des UUID d’objet exportés vers l’entrée de base de données name-service spécifiée par le paramètre EntryName dans la fonction RpcNsEntryObjectInqBegin .

Une application peut afficher tous les UUID d’objets exportés en appelant à plusieurs reprises RpcNsEntryObjectInqNext. Lorsque tous les UUID d’objet ont été consultés, cette fonction retourne un code RPC_S_NO_MORE_MEMBERS status. Les UUID d’objet retournés ne sont pas triés.

L’application fournit la mémoire pour l’UUID de l’objet retourné dans le paramètre ObjUuid .

Après avoir affiché les UUID d’objet, l’application doit appeler la fonction RpcNsEntryObjectInqDone pour libérer le contexte d’interrogation.

L’ordre dans lequel les UUID d’objet sont retournés peut être différent pour chaque affichage d’une entrée. Cela signifie que l’ordre dans lequel les UUID d’objet sont retournés à une application peut être différent chaque fois que l’application est exécutée.

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	rpcnsi.h (inclure Rpc.h)
Bibliothèque	Rpcns4.lib
DLL	Rpcns4.dll

Voir aussi

RpcNsBindingExport

RpcNsEntryObjectInqBegin

RpcNsEntryObjectInqDone

Partager via