RpcNsEntryExpandNameA-Funktion (rpcnsi.h)

  • Artikel

Die RpcNsEntryExpandName-Funktion erweitert einen Name-Dienst-Eintragsnamen. 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 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 zu erweiternden Eintragsnamen.

ExpandedName

Gibt einen Zeiger auf einen Zeiger auf die erweiterte Version von EntryName zurück.

Rückgabewert

Wert Bedeutung
RPC_S_OK
 Der Aufruf war erfolgreich.
RPC_S_INCOMPLETE_NAME
 Der Name ist unvollständig.
 
Hinweis Eine Liste der gültigen Fehlercodes finden Sie unter RPC-Rückgabewerte.
 

Hinweise

Eine Anwendung ruft die RpcNsEntryExpandName-Funktion auf, um einen vollständig erweiterten Eintragsnamen zu erhalten.

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

Der zurückgegebene erweiterte Eintragsname berücksichtigt lokale Namensübersetzungen und Unterschiede im lokal definierten Benennungsschema.

Hinweis Diese Funktion erfordert Active Directory-Unterstützung.
 

Hinweis

Der rpcnsi.h-Header definiert RpcNsEntryExpandName als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code 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 (include Rpc.h)
Bibliothek Rpcns4.lib
DLL Rpcns4.dll

Weitere Informationen

RpcStringFree