RpcNsBindingInqEntryNameW-Funktion (rpcdce.h)

Artikel
11/20/2024

Die RpcNsBindingInqEntryName Funktion gibt den Eintragsnamen zurück, aus dem das Bindungshandle stammt.

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

Syntax

RPC_STATUS RpcNsBindingInqEntryNameW(
  RPC_BINDING_HANDLE Binding,
  unsigned long      EntryNameSyntax,
  RPC_WSTR           *EntryName
);

Parameter

Binding

Bindungshandle, dessen Name-Dienst-Datenbankeintragsname zurückgegeben wird.

EntryNameSyntax

Syntax, die in EntryName-verwendet wird.

So verwenden Sie die im Registrierungswerteintrag angegebene Syntax

HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntax, geben Sie einen Wert von RPC_C_NS_SYNTAX_DEFAULT an.

EntryName

Gibt die Adresse eines Zeigers auf den Namen des Namensdienstdatenbankeintrags zurück, in dem Bindungs- gefunden wurde.

Geben Sie einen NULL-Wert an, um zu verhindern, dass RpcNsBindingInqEntryName den EntryName Parameter zurückgibt. In diesem Fall ruft die Anwendung die funktion RpcStringFree nicht auf.

Rückgabewert

Wert	Bedeutung
RPC_S_OK	Der Aufruf war erfolgreich.
RPC_S_INVALID_BINDING	Das Bindungshandle war ungültig.
RPC_S_NO_ENTRY_NAME	Kein Eintragsname für die Bindung.
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.

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

Bemerkungen

Die RpcNsBindingInqEntryName Funktion gibt den Namen des Namensnamens für den Dienst-Datenbankeintragsnamen zurück, aus dem ein clientkompatibles Bindungshandle stammt.

Die RPC-Laufzeitbibliothek weist Speicher für die im parameter EntryName zurückgegebene Zeichenfolge zu. Die Anwendung ist dafür verantwortlich, die RpcStringFree--Funktion aufzurufen, um diesen Speicher zu verwalten.

Ein Eintragsname ist nur mit Bindungshandles verknüpft, die von den funktionen RpcNsBindingImportNext, RpcNsBindingLookupNextund RpcNsBindingSelect- funktionen zurückgegeben werden.

Wenn das im Binding Parameter angegebene Bindungshandle nicht von einem Namensdienstdatenbankeintrag zurückgegeben wurde (z. B. wenn das Bindungshandle durch Aufrufen von RpcBindingFromStringBindingerstellt wurde), gibt RpcNsBindingInqEntryName eine leere Zeichenfolge ("\0") und einen RPC_S_NO_ENTRY_NAME Statuscode zurück.

Anmerkung

Der header rpcdce.h definiert RpcNsBindingInqEntryName 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-	rpcdce.h (include Rpc.h)
Library	Rpcrt4.lib
DLL-	Rpcrt4.dll

Siehe auch

RpcBindingFromStringBinding

RpcNsBindingImportNext-

RpcNsBindingLookupNext-

RpcNsBindingSelect-

RpcStringFree-

Freigeben über