Fonction RpcMgmtEpEltInqBegin (rpcdce.h)

Article
03/01/2024

La fonction RpcMgmtEpEltInqBegin crée un contexte d’interrogation pour afficher les éléments dans une carte de point de terminaison.

Syntaxe

RPC_STATUS RpcMgmtEpEltInqBegin(
  RPC_BINDING_HANDLE EpBinding,
  unsigned long      InquiryType,
  RPC_IF_ID          *IfId,
  unsigned long      VersOption,
  UUID               *ObjectUuid,
  RPC_EP_INQ_HANDLE  *InquiryContext
);

Paramètres

EpBinding

Handle de liaison à un hôte dont les éléments endpoint-map doivent être consultés. Spécifiez NULL pour afficher les éléments de l’hôte local. Si un handle de liaison est spécifié, l’UUID de l’objet sur le handle de liaison doit être NULL. Le cas échéant, le point de terminaison sur le handle de liaison est ignoré et le point de terminaison de la base de données du mappeur de point de terminaison sur l’hôte donné est utilisé.

InquiryType

Valeur entière qui indique le type d’interrogation à effectuer sur la carte du point de terminaison. Voici les types d’interrogation valides.

Valeur	Signification
RPC_C_EP_ALL_ELTS	Retourne chaque élément de la carte de point de terminaison. Les paramètres IfId, VersOption et ObjectUuid sont ignorés.
RPC_C_EP_MATCH_BY_IF	Recherche dans la carte de point de terminaison des éléments qui contiennent l’identificateur d’interface spécifié par les valeurs IfId et VersOption .
RPC_C_EP_MATCH_BY_OBJ	Recherche dans la carte de point de terminaison des éléments qui contiennent l’UUID d’objet spécifié par ObjectUuid.
RPC_C_EP_MATCH_BY_BOTH	Recherche dans la carte de point de terminaison des éléments qui contiennent l’identificateur d’interface et l’UUID d’objet spécifiés par IfId, VersOption et ObjectUuid.

IfId

Identificateur d’interface des éléments endpoint-map à retourner par RpcMgmtEpEltInqNext. Ce paramètre est utilisé uniquement lorsque InquiryType est RPC_C_EP_MATCH_BY_IF ou RPC_C_EP_MATCH_BY_BOTH. Sinon, il est ignoré.

VersOption

Spécifie la façon dont RpcMgmtEpEltInqNext utilise le paramètre IfId . Ce paramètre est utilisé uniquement lorsque InquiryType est RPC_C_EP_MATCH_BY_IF ou RPC_C_EP_MATCH_BY_BOTH. Sinon, il est ignoré. Les valeurs suivantes sont valides pour ce paramètre.

Valeur	Signification
RPC_C_VERS_ALL	Retourne les éléments endpoint-map qui offrent l’UUID d’interface spécifié, quels que soient les numéros de version.
RPC_C_VERS_COMPATIBLE	Renvoie les éléments de carte de point de terminaison qui offrent la même version majeure de l’UUID d’interface spécifié et une version mineure supérieure ou égale à la version mineure de l’UUID d’interface spécifiée.
RPC_C_VERS_EXACT	Retourne des éléments endpoint-map qui offrent la version spécifiée de l’UUID d’interface spécifié.
RPC_C_VERS_MAJOR_ONLY	Retourne les éléments endpoint-map qui offrent la même version majeure de l’UUID d’interface spécifié et ignore la version mineure.
RPC_C_VERS_UPTO	Renvoie des éléments de carte de point de terminaison qui offrent une version de l’UUID d’interface spécifiée inférieure ou égale à la version principale et secondaire spécifiée.

ObjectUuid

Objet UUID que RpcMgmtEpEltInqNext recherche dans les éléments endpoint-map. Ce paramètre est utilisé uniquement lorsque InquiryType est RPC_C_EP_MATCH_BY_OBJ ou RPC_C_EP_MATCH_BY_BOTH.

InquiryContext

Retourne un contexte de demande à utiliser avec RpcMgmtEpEltInqNext et RpcMgmtEpEltInqDone. Voir RPC_EP_INQ_HANDLE.

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 RpcMgmtEpEltInqBegin crée un contexte de demande pour afficher les informations d’adresse du serveur stockées dans la carte de point de terminaison. À l’aide de InquiryType et de VersOption, une application spécifie quels éléments de carte de point de terminaison suivants doivent être retournés à partir d’appels à RpcMgmtEpEltInqNext :

Tous les éléments
Éléments avec l’identificateur d’interface spécifié
Éléments avec l’UUID de l’objet spécifié
Ces éléments avec l’identificateur d’interface et l’UUID d’objet spécifiés

Avant d’appeler RpcMgmtEpEltInqNext, l’application doit d’abord appeler cette fonction pour créer un contexte de demande. Après avoir affiché les éléments endpoint-map, l’application appelle 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

RpcMgmtEpEltInqDone

RpcMgmtEpEltInqNext

Partager via