Partager via

RpcNsProfileEltAddA, fonction (rpcnsi.h)

  • Article

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

Note Cette fonction n’est pas prise en charge sur Windows Vista et les systèmes d’exploitation 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 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
RPC_S_OK
 L’appel a réussi.
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_NAME_SERVICE_UNAVAILABLE
 Nom de service indisponible.
 
Note Pour obtenir la liste des codes d’erreur valides, consultez Valeurs de retour RPC.
 

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 .

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

Voir aussi

RpcIfInqId

RpcNsMgmtEntryCreate

RpcNsProfileEltRemove