RpcNsProfileEltAddA, fonction (rpcnsi.h)

Article
11/20/2024

La fonction RpcNsProfileEltAdd ajoute un élément à un profil. Si nécessaire, il crée l’entrée.

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

Syntaxe

RPC_STATUS RpcNsProfileEltAddA(
  unsigned long ProfileNameSyntax,
  RPC_CSTR      ProfileName,
  RPC_IF_ID     *IfId,
  unsigned long MemberNameSyntax,
  RPC_CSTR      MemberName,
  unsigned long Priority,
  RPC_CSTR      Annotation
);

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 pour recevoir un nouvel élément.

IfId

Pointeur vers l’identification de l’interface du nouvel élément de profil. Pour ajouter ou remplacer l’élément de profil par défaut, spécifiez une valeur Null.

MemberNameSyntax

Syntaxe de MemberName.

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 un nom d’entrée de service de nom à inclure dans le nouvel élément de profil.

Priority

Valeur entière (0 à 7) qui indique la priorité relative pour l’utilisation du nouvel élément de profil pendant les opérations d’importation et de recherche. La valeur 0 est la priorité la plus élevée ; la valeur 7 est la priorité la plus basse. Lors de l’ajout d’un membre de profil par défaut, utilisez la valeur 0.

Annotation

Pointeur vers une chaîne d’annotation stockée dans le cadre du nouvel élément de profil. Spécifiez une valeur Null ou une chaîne terminée par null s’il n’existe aucune chaîne d’annotation.

La chaîne est utilisée par les applications uniquement à des fins d’information. Par exemple, une application peut utiliser cette chaîne pour stocker la chaîne de nom d’interface spécifiée dans le fichier IDL. RPC n’utilise pas la chaîne d’annotation pendant les opérations de recherche ou d’importation ou pour énumérer les éléments de profil.

Valeur de retour

Valeur	Signification
RPC_S_OK	L’appel a réussi.
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_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 RpcNsProfileEltAdd ajoute un élément à l’attribut de profil de l’entrée name-service spécifiée par ProfileName. Si l’entrée ProfileName n’existe pas, RpcNsProfileEltAd d tente de créer l’entrée avec un attribut de profil et ajoute l’élément de profil spécifié par l'IfId, MemberName, Priorityet paramètres d’annotation. Dans ce cas, l’application doit avoir le privilège de créer l’entrée. Sinon, une application de gestion avec les privilèges nécessaires doit créer l’entrée en appelant la fonction RpcNsMgmtEntryCreate avant l’exécution de l’application.

Si un élément avec le nom de membre et l’identification d’interface spécifiés se trouvent déjà dans le profil, RpcNsProfileEltAdd met à jour la chaîne de priorité et d’annotation de l’élément à l’aide des valeurs fournies dans les paramètres priorité et Annotation.

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 RpcNsProfileEltAdd 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

RpcNsMgmtEntryCreate

RpcNsProfileEltRemove

Partager via