RpcNsBindingInqEntryNameA-Funktion (rpcdce.h)

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 RpcNsBindingInqEntryNameA(
  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, aus dem ein clientkompatibles Bindungshandle stammt.

Die RPC-Laufzeitbibliothek weist Arbeitsspeicher für die im EntryName-Parameter zurückgegebene Zeichenfolge zu. Die Anwendung ist für den Aufruf der RpcStringFree-Funktion verantwortlich, um die Zuordnung dieses Arbeitsspeichers zu beheben.

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

Hinweis

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

Weitere Informationen

RpcBindingFromStringBinding

RpcNsBindingImportNext

RpcNsBindingLookupWeiter

RpcNsBindingSelect

RpcStringFree