RpcNsProfileEltRemoveA-Funktion (rpcnsi.h)

  • Artikel

Die RpcNsProfileEltRemove-Funktion entfernt ein Element aus einem Profil.

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

Syntax

RPC_STATUS RpcNsProfileEltRemoveA(
  unsigned long ProfileNameSyntax,
  RPC_CSTR      ProfileName,
  RPC_IF_ID     *IfId,
  unsigned long MemberNameSyntax,
  RPC_CSTR      MemberName
);

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, aus dem ein Element entfernt werden soll.

IfId

Zeiger auf die Schnittstellenidentifikation des zu entfernenden Profilelements.

Geben Sie einen NULL-Wert an, um den Standardprofilmember zu entfernen.

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 den Namen des Diensteintrags im zu entfernenden Profilelement.

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_ENTRY_NOT_FOUND
 Der Name-Dienst-Eintrag wurde nicht gefunden.
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 RpcNsProfileEltRemove-Funktion entfernt ein profilelement aus dem profile-Attribut im ProfileName-Eintrag . Diese Funktion erfordert eine genaue Übereinstimmung der MemberName - und IfId-Parameter , um ein Profilelement zu entfernen. Der Eintrag (MemberName), der als Mitglied im Profilelement enthalten ist, wird nicht gelöscht.

Hinweis Verwenden Sie RpcNsProfileEltRemove vorsichtig: Das Entfernen von Elementen aus einem Profil kann den unerwünschten Effekt haben, dass eine Hierarchie von Profilen aufgebrochen 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 rpcnsi.h-Header definiert RpcNsProfileEltRemove 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
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

RpcNsProfileDelete

RpcNsProfileEltAdd