Partager via

RpcNsProfileEltInqBeginW, fonction (rpcnsi.h)

  • Article

La fonction RpcNsProfileEltInqBegin crée un contexte de recherche pour afficher les éléments d’un profil.

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

Syntaxe

RPC_STATUS RpcNsProfileEltInqBeginW(
  unsigned long ProfileNameSyntax,
  RPC_WSTR      ProfileName,
  unsigned long InquiryType,
  RPC_IF_ID     *IfId,
  unsigned long VersOption,
  unsigned long MemberNameSyntax,
  RPC_WSTR      MemberName,
  RPC_NS_HANDLE *InquiryContext
);

Paramètres

ProfileNameSyntax

Syntaxe de ProfileName.

Pour utiliser la syntaxe spécifiée dans l’entrée de valeur de Registre HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntax, fournissez la valeur RPC_C_NS_SYNTAX_DEFAULT.

ProfileName

Pointeur vers le nom du profil à afficher.

InquiryType

Type d’enquête à effectuer sur le profil. Le tableau suivant répertorie les types d’interrogation valides.

Type d’enquête Signification
RPC_C_PROFILE_DEFAULT_ELT
 Recherche dans le profil l’élément de profil par défaut, le cas échéant. Les paramètres IfId, VersOption et MemberName sont ignorés.
RPC_C_PROFILE_ALL_ELTS
 Retourne chaque élément du profil. Les paramètres IfId, VersOption et MemberName sont ignorés.
RPC_C_PROFILE_MATCH_BY_IF
 Recherche dans le profil les éléments qui contiennent l’identification d’interface spécifiée par IfId et VersOption. Le paramètre MemberName est ignoré.
RPC_C_PROFILE_MATCH_BY_MBR
 Recherche dans le profil les éléments qui contiennent MemberName. Les paramètres IfId et VersOption sont ignorés.
RPC_C_PROFILE_MATCH_BY_BOTH
 Recherche dans le profil les éléments qui contiennent l’identification de l’interface et le membre identifiés par les paramètres IfId, VersOption et MemberName .

IfId

Pointeur vers l’identification d’interface des éléments de profil à retourner par la fonction RpcNsProfileEltInqNext .

Le paramètre IfId est utilisé uniquement lors de la spécification d’une valeur de RPC_C_PROFILE_MATCH_BY_IF ou RPC_C_PROFILE_MATCH_BY_BOTH pour le paramètre InquiryType . Sinon, IfId est ignoré et une valeur Null peut être spécifiée.

VersOption

Spécifie comment la fonction RpcNsProfileEltInqNext utilise le paramètre IfId . Ce paramètre est utilisé uniquement lors de la spécification d’une valeur de RPC_C_PROFILE_MATCH_BY_IF ou RPC_C_PROFILE_MATCH_BY_BOTH pour InquiryType. Sinon, ce paramètre est ignoré et une valeur 0 peut être spécifiée.

Le tableau suivant décrit les valeurs valides pour VersOption.

Valeur Signification
RPC_C_VERS_ALL
 Retourne des éléments de profil qui offrent l’UUID d’interface spécifié, quels que soient les numéros de version. Pour cette valeur, spécifiez 0 pour les versions principale et secondaire dans IfId.
RPC_C_VERS_COMPATIBLE
 Retourne des éléments de profil qui offrent la même version principale 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 de profil qui offrent la version spécifiée de l’UUID de l’interface spécifiée.
RPC_C_VERS_MAJOR_ONLY
 Retourne des éléments de profil qui offrent la même version principale de l’UUID d’interface spécifié (ignore la version mineure). Pour cette valeur, spécifiez 0 pour la version mineure dans IfId.
RPC_C_VERS_UPTO
 Retourne des éléments de profil qui offrent une version de l’UUID d’interface spécifiée inférieure ou égale à la version principale et secondaire spécifiée. (Par exemple, si l’IfId contenait V2.0 et que le profil contenait des éléments avec V1.3, V2.0 et V2.1, la fonction RpcNsProfileEltInqNext renvoie des éléments avec V1.3 et V2.0.)

MemberNameSyntax

Syntaxe de MemberName et paramètre de retour MemberName dans la fonction RpcNsProfileEltInqNext .

Pour utiliser la syntaxe spécifiée dans l’entrée de valeur de Registre HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntax, fournissez la valeur RPC_C_NS_SYNTAX_DEFAULT.

MemberName

Pointeur vers le nom de membre que la fonction RpcNsProfileEltInqNext recherche dans les éléments de profil. Le paramètre MemberName est utilisé uniquement lors de la spécification d’une valeur de RPC_C_PROFILE_MATCH_BY_MBR ou RPC_C_PROFILE_MATCH_BY_BOTH pour InquiryType. Sinon, MemberName est ignoré et une valeur Null peut être spécifiée.

InquiryContext

Retourne un pointeur vers un handle de service de nom à utiliser avec les fonctions RpcNsProfileEltInqNext et RpcNsProfileEltInqDone .

Valeur retournée

Valeur Signification
RPC_S_OK
 L’appel a réussi.
RPC_S_INVALID_VERS_OPTION
 Option de version non valide.
RPC_S_INVALID_NAME_SYNTAX
 La syntaxe de nom n’est pas valide.
RPC_S_UNSUPPORTED_NAME_SYNTAX
 La syntaxe de nom n’est pas prise en charge.
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 RpcNsProfileEltInqBegin crée un contexte de recherche pour afficher les éléments d’un profil.

À l’aide du paramètre InquiryType , une application spécifie quels éléments de profil suivants doivent être retournés à partir des appels à RpcNsProfileEltInqNext :

  • Élément par défaut
  • Tous les éléments
  • Éléments avec l’identification d’interface spécifiée
  • Éléments avec le nom de membre spécifié
  • Éléments avec l’identification d’interface et le nom de membre spécifiés
Avant d’appeler RpcNsProfileEltInqNext, l’application doit d’abord appeler RpcNsProfileEltInqBegin pour créer un contexte de recherche.

Lorsque vous avez terminé d’afficher les éléments de profil, l’application appelle la fonction RpcNsProfileEltInqDone pour supprimer le contexte de recherche.

Note Windows 2000 Active Directory prend en charge cette fonction. Les versions antérieures de Windows NT prennent en charge l’utilisation de cette fonction avec le service CDS (Cell Directory Service) uniquement.
 

Notes

L’en-tête rpcnsi.h définit RpcNsProfileEltInqBegin 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. La combinaison 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 rpcnsi.h (inclure Rpc.h)
Bibliothèque Rpcns4.lib
DLL Rpcns4.dll

Voir aussi

RpcIfInqId

RpcNsProfileEltInqDone

RpcNsProfileEltInqNext