RpcNsProfileEltAddA-Funktion (rpcnsi.h)
Die funktion RpcNsProfileEltAdd fügt einem Profil ein Element hinzu. Bei Bedarf wird der Eintrag erstellt.
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 des ProfileName-.
Um die im Registrierungswerteintrag HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntaxangegebene Syntax zu verwenden, geben Sie einen Wert von RPC_C_NS_SYNTAX_DEFAULT an.
ProfileName
Zeigen Sie auf den Namen des Profils, um ein neues Element zu erhalten.
IfId
Zeigen Sie auf die Schnittstellenidentifikation des neuen Profilelements. Wenn Sie das Standardprofilelement hinzufügen oder ersetzen möchten, geben Sie einen NULL-Wert an.
MemberNameSyntax
Syntax von MemberName.
Um die im Registrierungswerteintrag HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntaxangegebene Syntax zu verwenden, geben Sie einen Wert von RPC_C_NS_SYNTAX_DEFAULT an.
MemberName
Zeigen Sie auf einen Namendiensteintragsnamen, 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 des Import- und Nachschlagevorgangs angibt. Der Wert 0 ist die höchste Priorität; Ein Wert von 7 ist die niedrigste Priorität. Verwenden Sie beim Hinzufügen eines Standardprofilelements den Wert 0.
Annotation
Zeigen Sie auf eine Anmerkungszeichenfolge, die als Teil des neuen Profilelements gespeichert ist. Geben Sie einen NULL-Wert oder eine mit Null beendete Zeichenfolge an, wenn keine Anmerkungszeichenfolge vorhanden ist.
Die Zeichenfolge wird nur für Informationszwecke von Anwendungen 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 |
|---|---|
|
Der Aufruf war erfolgreich. |
|
Die Namenssyntax ist ungültig. |
|
Die Namenssyntax wird nicht unterstützt. |
|
Der Name ist unvollständig. |
|
Der Namensdienst ist nicht verfügbar. |
Bemerkungen
Die funktion RpcNsProfileEltAdd fügt dem Profilattribute des durch ProfileNameangegebenen Namendiensteintrags ein Element hinzu. Wenn der eintrag ProfileName nicht vorhanden ist, versucht RpcNsProfileEltAd d, den Eintrag mit einem Profilattribute zu erstellen und das profilelement, das durch die parameter IfId, MemberName, Priorityund Annotation Parameter 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 Sie die RpcNsMgmtEntryCreate-Funktion aufrufen, bevor die Anwendung ausgeführt wird.
Wenn sich ein Element mit dem angegebenen Elementnamen und der Schnittstellenidentifikation bereits im Profil befindet, aktualisiert RpcNsProfileEltAdd die Prioritäts- und Anmerkungszeichenfolge des Elements mithilfe der werte der Priority und Annotation Parameter.
Anmerkung
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
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 2000 Professional [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | rpcnsi.h (include Rpc.h) |
| Library | Rpcns4.lib |
| DLL- | Rpcns4.dll |