RpcNsBindingInqEntryName-Funktion (rpcdce.h)

Artikel
08/25/2023

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

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

Syntax

RPC_STATUS RpcNsBindingInqEntryName(
  RPC_BINDING_HANDLE Binding,
  unsigned long      EntryNameSyntax,
  RPC_CSTR           *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\DefaultSyntaxgeben Sie den Wert RPC_C_NS_SYNTAX_DEFAULT an.

EntryName

Gibt die Adresse eines Zeigers auf den Namen des Datenbankeintrags name-service zurück, in dem Binding 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 RpcStringFree-Funktion 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 der gültigen Fehlercodes finden Sie unter RPC-Rückgabewerte.

Hinweise

Die RpcNsBindingInqEntryName-Funktion gibt den Namen des Namens service–database entry name zurück, von dem ein clientkompatibles Bindungshandle stammt.

Die RPC-Laufzeitbibliothek ordnet Arbeitsspeicher für die im EntryName-Parameter zurückgegebene Zeichenfolge zu. Die Anwendung ist dafür verantwortlich, die RpcStringFree-Funktion aufzurufen, um die Zuordnung dieses Arbeitsspeichers aufzugeben.

Ein Eintragsname ist nur Bindungshandles zugeordnet, die von den Funktionen RpcNsBindingImportNext, RpcNsBindingLookupNext und RpcNsBindingSelect zurückgegeben werden.

Wenn das im Binding-Parameter angegebene Bindungshandle nicht von einem Name-Dienst-Datenbankeintrag zurückgegeben wurde (z. B. wenn das Bindungshandle durch Aufrufen von RpcBindingFromStringBinding erstellt wurde), gibt RpcNsBindingInqEntryName eine leere Zeichenfolge ("\0") und einen RPC_S_NO_ENTRY_NAME status Code zurück.

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	rpcdce.h (rpc.h einschließen)
Bibliothek	Rpcrt4.lib
DLL	Rpcrt4.dll

Weitere Informationen

RpcBindingFromStringBinding

RpcNsBindingImportNext

RpcNsBindingLookupWeiter

RpcNsBindingSelect

RpcStringFree

Freigeben über