RpcNsGroupMbrAddA-Funktion (rpcnsi.h)

Artikel
03/01/2024

Die RpcNsGroupMbrAdd-Funktion fügt einer Gruppe einen Eintragsnamen hinzu. Bei Bedarf wird der Eintrag erstellt.

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

Syntax

RPC_STATUS RpcNsGroupMbrAddA(
  unsigned long GroupNameSyntax,
  RPC_CSTR      GroupName,
  unsigned long MemberNameSyntax,
  RPC_CSTR      MemberName
);

Parameter

GroupNameSyntax

Syntax von GroupName.

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.

GroupName

Zeiger auf den Namen der RPC-Gruppe, um ein neues Mitglied zu erhalten.

MemberNameSyntax

Syntax, die in MemberName verwendet werden soll.

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 den Namen des neuen RPC-Gruppenmitglieds.

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

RpcNsGroupMbrAdd fügt dem RPC-Group-Attribut einen Namensdienst-Datenbankeintragsnamen als Mitglied hinzu.

Wenn der GroupName-Eintrag nicht vorhanden ist, versucht RpcNsGroupMbrAdd , den Eintrag mit einem group-Attribut zu erstellen, und fügt das durch MemberName angegebene Gruppenmitglied hinzu. 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 RpcNsMgmtEntryCreate aufgerufen wird, bevor die Anwendung ausgeführt wird.

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 header rpcnsi.h definiert RpcNsGroupMbrAdd als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code 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
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 (include Rpc.h)
Bibliothek	Rpcns4.lib
DLL	Rpcns4.dll

Weitere Informationen

RpcNsGroupMbrRemove

RpcNsMgmtEntryCreate

Freigeben über