RpcNsProfileEltAddA, fonction (rpcnsi.h)
La fonction RpcNsProfileEltAdd ajoute un élément à un profil. Si nécessaire, il crée l’entrée.
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 la valeur 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 la valeur RPC_C_NS_SYNTAX_DEFAULT.
MemberName
Pointeur vers un nom d’entrée de service à 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. Lorsque vous ajoutez 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’y a pas de chaîne d’annotation.
La chaîne est utilisée par les applications à titre d’information uniquement. 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 l’énumération d’éléments de profil.
Valeur retournée
Valeur | Signification |
---|---|
|
L’appel a réussi. |
|
La syntaxe de nom n’est pas valide. |
|
La syntaxe de nom n’est pas prise en charge. |
|
Le nom est incomplet. |
|
Nom de service indisponible. |
Notes
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, RpcNsProfileEltAdd tente de créer l’entrée avec un attribut de profil et ajoute l’élément de profil spécifié par les paramètres IfId, MemberName, Priority et Annotation . Dans ce cas, l’application doit avoir le privilège de créer l’entrée. Sinon, une application de gestion disposant des 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 spécifié et l’identification de l’interface se trouve déjà dans le profil, RpcNsProfileEltAdd met à jour la priorité et la chaîne d’annotation de l’élément à l’aide des valeurs fournies dans les paramètres Priority et Annotation .
Notes
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. 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.
Spécifications
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 |