RpcNsProfileDeleteW-Funktion (rpcnsi.h)

Artikel
11/20/2024

Die RpcNsProfileDelete-Funktion löscht ein Profilattribute.

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

Syntax

RPC_STATUS RpcNsProfileDeleteW(
  unsigned long ProfileNameSyntax,
  RPC_WSTR      ProfileName
);

Parameter

ProfileNameSyntax

Ganzzahliger Wert, der die Syntax des nächsten Parameters angibt, ProfileName.

Um die im Registrierungswert 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 zu löschenden Profils.

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.

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

Bemerkungen

Die RpcNsProfileDelete-Funktion löscht das Profilattribute aus dem angegebenen Namensdiensteintrag (ProfileName). Weder ProfileName noch die Eintragsnamen, die als Mitglieder in jedem Profilelement enthalten sind, werden gelöscht.

HinweisRpcNsProfileDelete vorsichtig verwenden; Das Löschen eines Profils kann die unerwünschte Auswirkung haben, eine Hierarchie von Profilen zu unterbrechen.

Hinweis Diese DCE-Funktion wird von Microsoft Locator nicht unterstützt. Windows NT und Windows 2000 unterstützen nur die Verwendung dieser Funktion mit Cell Directory Service (CDS).

Anmerkung

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

RpcNsProfileEltAdd

RpcNsProfileEltRemove

Freigeben über