Partager via

RpcNsProfileEltInqBeginA, fonction (rpcnsi.h)

  • Article

La fonction RpcNsProfileEltInqBegin crée un contexte d’enquête pour afficher les éléments d’un profil.

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

Syntaxe

RPC_STATUS RpcNsProfileEltInqBeginA(
  unsigned long ProfileNameSyntax,
  RPC_CSTR      ProfileName,
  unsigned long InquiryType,
  RPC_IF_ID     *IfId,
  unsigned long VersOption,
  unsigned long MemberNameSyntax,
  RPC_CSTR      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 une valeur de 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’enquête valides.

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

IfId

Pointeur vers l’identification de l’interface des éléments de profil à renvoyer 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 de 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 de 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 de l’interface spécifiée, quel que soit le numéro de version. Pour cette valeur, spécifiez 0 pour les versions principales et mineures 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ée et une version mineure supérieure ou égale à la version mineure de l’UUID de l’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 de l’interface spécifiée (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 mineure spécifiée. (Par exemple, si les IfId contenaient V2.0 et que le profil contenait des éléments avec V1.3, V2.0 et V2.1, la fonction RpcNsProfileEltInq Next retourne des éléments avec V1.3 et V2.0.)

MemberNameSyntax

Syntaxe de MemberName et du 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 une valeur de RPC_C_NS_SYNTAX_DEFAULT.

MemberName

Pointeur vers le nom du 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 de 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 de retour

Valeur Signification
RPC_S_OK
 L’appel a réussi.
RPC_S_INVALID_VERS_OPTION
 L’option de version n’est pas valide.
RPC_S_INVALID_NAME_SYNTAX
 La syntaxe du nom n’est pas valide.
RPC_S_UNSUPPORTED_NAME_SYNTAX
 La syntaxe du nom n’est pas prise en charge.
RPC_S_INCOMPLETE_NAME
 Le nom est incomplet.
RPC_S_ENTRY_NOT_FOUND
 L’entrée nom-service est introuvable.
RPC_S_NAME_SERVICE_UNAVAILABLE
 Le service de noms n’est pas disponible.
 
Remarque Pour obtenir la liste des codes d’erreur valides, consultez valeurs de retour RPC.
 

Remarques

La fonction RpcNsProfileEltInqBegin crée un contexte d’enquête pour afficher les éléments d’un profil.

À l’aide du paramètre InquiryType , une application spécifie les éléments de profil suivants à renvoyer à partir d’appels à RpcNsProfileEltInqNext:

  • Élément par défaut
  • Tous les éléments
  • Éléments avec l’identification de l’interface spécifiée
  • Éléments avec le nom de membre spécifié
  • Éléments avec l’identification de l’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 d’enquête.

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

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

Note

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

Voir aussi

RpcIfInqId

RpcNsProfileEltInqDone

RpcNsProfileEltInqNext