RpcBindingToStringBinding-Funktion (rpcdce.h)

Artikel
03/04/2024

Die RpcBindingToStringBinding-Funktion gibt eine Zeichenfolgendarstellung eines Bindungshandles zurück.

Syntax

RPC_STATUS RpcBindingToStringBinding(
  RPC_BINDING_HANDLE Binding,
  RPC_CSTR           *StringBinding
);

Parameter

Binding

Client- oder Serverbindungshandle, um in eine Zeichenfolgendarstellung eines Bindungshandles zu konvertieren.

StringBinding

Gibt einen Zeiger auf einen Zeiger auf die Zeichenfolgendarstellung des im Binding-Parameter angegebenen Bindungshandles zurück.

Geben Sie einen NULL-Wert an, um zu verhindern , dass RpcBindingToStringBinding den StringBinding-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.

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

Hinweise

Die RpcBindingToStringBinding-Funktion konvertiert ein Client- oder Serverbindungshandle in seine Zeichenfolgendarstellung.

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

Wenn das Bindungshandle im Binding-Parameter eine UUID des Nullobjekts enthielt, ist das Objekt-UUID-Feld nicht in der zurückgegebenen Zeichenfolge enthalten.

Um den zurückgegebenen StringBinding-Parameter zu analysieren, rufen Sie die RpcStringBindingParse-Funktion auf.

Hinweis Um die Adresse eines Clients abzufragen, ruft eine Anwendung zunächst die RpcBindingServerFromClient-Funktion auf, um ein teilweise gebundenes Serverbindungshandle abzurufen. Das Serverbindungshandle kann verwendet werden, um eine Zeichenfolgenbindung abzurufen, indem RpcBindingToStringBinding aufgerufen wird. Der Server kann dann RpcStringBindingParse aufrufen, um die Netzwerkadresse des Clients aus der Zeichenfolgenbindung zu extrahieren.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	rpcdce.h (include Rpc.h)
Bibliothek	Rpcrt4.lib
DLL	Rpcrt4.dll

Weitere Informationen

RpcBindingFromStringBinding

RpcStringBindingParse

RpcStringFree

Freigeben über