RpcNsMgmtEntryDeleteA-Funktion (rpcnsi.h)

Die RpcNsMgmtEntryDelete-Funktion löscht einen Namenseintrag service–database.

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 von EntryName.

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.

EntryName

Zeiger 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-Dienst-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 der gültigen Fehlercodes finden Sie unter RPC-Rückgabewerte.

 

Hinweise

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

Da Name-Dienst-Datenbanken 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 Name-Dienst-Datenbank denselben Eintrag wiederholt entfernt und ersetzt. Dies kann zu Leistungsproblemen in replizierten Namensdienstdatenbanken führen.

Hinweis

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

RpcNsMgmtEntryCreate