RpcNsEntryExpandNameA-Funktion (rpcnsi.h)

Die RpcNsEntryExpandName-Funktion erweitert einen Namen des Diensteintrags. Diese Funktion wird von Active Directory unterstützt.

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

 

Syntax

RPC_STATUS RpcNsEntryExpandNameA(
  unsigned long EntryNameSyntax,
  RPC_CSTR      EntryName,
  RPC_CSTR      *ExpandedName
);

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

EntryName

Zeigen Sie auf den zu erweiternden Eintragsnamen.

ExpandedName

Gibt einen Zeiger auf einen Zeiger auf die erweiterte Version von EntryNamezurück.

Rückgabewert

Wert	Bedeutung
RPC_S_OK	Der Aufruf war erfolgreich.
RPC_S_INCOMPLETE_NAME	Der Name ist unvollständig.

 

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

 

Bemerkungen

Eine Anwendung ruft die funktion RpcNsEntryExpandName auf, um einen vollständig erweiterten Eintragsnamen abzurufen.

Die RPC-Laufzeitbibliothek weist Speicher für den zurückgegebenen ExpandedName Parameter zu. Die Anwendung ist dafür verantwortlich, die RpcStringFree--Funktion für diese zurückgegebene Zeichenfolge aufzurufen.

Die zurückgegebenen erweiterten Eintragsnamen konten für lokale Namensübersetzungen und für Unterschiede im lokal definierten Benennungsschema.

Hinweis Diese Funktion erfordert Active Directory-Unterstützung.

 

Anmerkung

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

RpcStringFree-