RpcNsMgmtEntryDeleteA-Funktion (rpcnsi.h)

Artikel
11/20/2024

Die RpcNsMgmtEntryDelete-Funktion löscht einen Namendienstdatenbankeintrag.

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

Syntax

RPC_STATUS RpcNsMgmtEntryDeleteA(
  unsigned long EntryNameSyntax,
  RPC_CSTR      EntryName
);

Parameter

EntryNameSyntax

Syntax des EntryName-.

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.

EntryName

Zeigen Sie auf den Namen des zu löschenden Eintrags.

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-Service-Eintrag wurde nicht gefunden.
RPC_S_NAME_SERVICE_UNAVAILABLE	Der Namensdienst ist nicht verfügbar.
RPC_S_NOT_RPC_ENTRY	Kein RPC-Eintrag.

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

Bemerkungen

Verwaltungsanwendungen verwenden die funktion RpcNsMgmtEntryDelete nur, wenn ein Eintrag nicht mehr benötigt wird, z. B. wenn ein Server dauerhaft aus dem Dienst entfernt wird.

Da Namensdienstdatenbanken relativ stabil sind, kann die häufige Verwendung von RpcNsMgmtEntryDelete in Client- oder Serveranwendungen zu Leistungsproblemen führen. Das Erstellen und Löschen von Einträgen in Client- oder Serveranwendungen bewirkt, dass die Namensdienstdatenbank wiederholt denselben Eintrag entfernt und ersetzt. Dies kann zu Leistungsproblemen in replizierten Namensdienstdatenbanken führen.

Anmerkung

Der rpcnsi.h-Header definiert RpcNsMgmtEntryDelete 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

Siehe auch

RpcNsMgmtEntryCreate

Freigeben über