RpcBindingToStringBinding-Funktion (rpcdce.h)
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 |
|---|---|
|
Der Aufruf war erfolgreich. |
|
Das Bindungshandle war ungültig. |
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.
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 |