RpcNsProfileEltAddA-Funktion (rpcnsi.h)

Die RpcNsProfileEltAdd-Funktion fügt einem Profil ein Element hinzu. Bei Bedarf wird der Eintrag erstellt.

Hinweis Diese Funktion wird unter Windows Vista und höheren Betriebssystemen nicht unterstützt.

 

Syntax

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

Parameter

ProfileNameSyntax

Syntax von ProfileName.

Um die im Registrierungswerteintrag HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntaxangegebene Syntax zu verwenden, geben Sie den Wert RPC_C_NS_SYNTAX_DEFAULT an.

ProfileName

Zeiger auf den Namen des Profils, um ein neues Element zu empfangen.

IfId

Zeiger auf die Schnittstellenidentifikation des neuen Profilelements. Geben Sie einen NULL-Wert an, um das Standardprofilelement hinzuzufügen oder zu ersetzen.

MemberNameSyntax

Syntax von MemberName.

Um die im Registrierungswerteintrag HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntaxangegebene Syntax zu verwenden, geben Sie den Wert RPC_C_NS_SYNTAX_DEFAULT an.

MemberName

Zeiger auf einen Namensdienst–Eintragsnamen, der in das neue Profilelement aufgenommen werden soll.

Priority

Ganzzahliger Wert (0 bis 7), der die relative Priorität für die Verwendung des neuen Profilelements während der Import- und Nachschlagevorgänge angibt. Der Wert 0 ist die höchste Priorität. der Wert 7 ist die niedrigste Priorität. Verwenden Sie beim Hinzufügen eines Standardprofilmembers den Wert 0.

Annotation

Zeiger auf eine Anmerkungszeichenfolge, die als Teil des neuen Profilelements gespeichert ist. Geben Sie einen NULL-Wert oder eine null-endende Zeichenfolge an, wenn keine Anmerkungszeichenfolge vorhanden ist.

Die Zeichenfolge wird von Anwendungen nur zu Informationszwecken verwendet. Beispielsweise kann eine Anwendung diese Zeichenfolge verwenden, um die in der IDL-Datei angegebene Schnittstellennamenzeichenfolge zu speichern. RPC verwendet die Anmerkungszeichenfolge nicht bei Nachschlage- oder Importvorgängen oder zum Aufzählen von Profilelementen.

Rückgabewert

Wert	Bedeutung
RPC_S_OK	Der Aufruf war erfolgreich.
RPC_S_INVALID_NAME_SYNTAX	Die Namenssyntax ist ungültig.
RPC_S_UNSUPPORTED_NAME_SYNTAX	Die Namenssyntax wird nicht unterstützt.
RPC_S_INCOMPLETE_NAME	Der Name ist unvollständig.
RPC_S_NAME_SERVICE_UNAVAILABLE	Der Namensdienst ist nicht verfügbar.

 

Hinweis Eine Liste der gültigen Fehlercodes finden Sie unter RPC-Rückgabewerte.

 

Hinweise

Die RpcNsProfileEltAdd-Funktion fügt dem profil-Attribut des durch ProfileName angegebenen Name-Service-Eintrags ein Element hinzu. Wenn der ProfileName-Eintrag nicht vorhanden ist, versucht RpcNsProfileEltAdd , den Eintrag mit einem profil-Attribut zu erstellen, und fügt das profilelement hinzu, das durch die Parameter IfId, MemberName, Priority und Annotation angegeben wird. In diesem Fall muss die Anwendung über die Berechtigung zum Erstellen des Eintrags verfügen. Andernfalls sollte eine Verwaltungsanwendung mit den erforderlichen Berechtigungen den Eintrag erstellen, indem die RpcNsMgmtEntryCreate-Funktion aufgerufen wird, bevor die Anwendung ausgeführt wird.

Wenn sich ein Element mit dem angegebenen Membernamen und der angegebenen Schnittstellenidentifikation bereits im Profil befindet, aktualisiert RpcNsProfileEltAdd die Prioritäts- und Anmerkungszeichenfolge des Elements mithilfe der werte, die in den Parametern Priority und Annotation bereitgestellt werden.

Hinweis Windows 2000 Active Directory unterstützt diese Funktion. Frühere Versionen von Windows NT unterstützen die Verwendung dieser Funktion nur mit Cell Directory Service (CDS).

 

Hinweis

Der rpcnsi.h-Header definiert RpcNsProfileEltAdd als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	rpcnsi.h (rpc.h einschließen)
Bibliothek	Rpcns4.lib
DLL	Rpcns4.dll

Weitere Informationen

RpcIfInqId

RpcNsMgmtEntryCreate

RpcNsProfileEltRemove