RpcNsProfileDeleteA-Funktion (rpcnsi.h)

  • Artikel

Die RpcNsProfileDelete-Funktion löscht ein Profilattribute.

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

Syntax

RPC_STATUS RpcNsProfileDeleteA(
  unsigned long ProfileNameSyntax,
  RPC_CSTR      ProfileName
);

Parameter

ProfileNameSyntax

Integer-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 den Wert RPC_C_NS_SYNTAX_DEFAULT an.

ProfileName

Zeiger 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-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 RpcNsProfileDelete-Funktion löscht das profil-Attribut aus dem angegebenen Name-Diensteintrag (ProfileName). Weder ProfileName noch die Eintragsnamen, die als Member in jedem Profilelement enthalten sind, werden gelöscht.

Hinweis Verwenden Sie RpcNsProfileDelete vorsichtig; Das Löschen eines Profils kann den unerwünschten Effekt haben, dass eine Hierarchie von Profilen aufgebrochen wird.
 
Hinweis Diese DCE-Funktion wird vom Microsoft Locator nicht unterstützt. Windows NT und Windows 2000 unterstützen die Verwendung dieser Funktion nur mit Cell Directory Service (CDS).
 

Hinweis

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

RpcNsProfileEltAdd

RpcNsProfileEltRemove