RpcStringBindingParseA-Funktion (rpcdce.h)

Artikel
11/20/2024

Die RpcStringBindingParse--Funktion gibt den Objekt-UUID-Teil und die Adressteile einer Zeichenfolgenbindung als separate Zeichenfolgen zurück. Eine Anwendung ruft RpcStringBindingParse- auf, um eine Zeichenfolgendarstellung eines Bindungshandles in die zugehörigen Komponentenfelder zu analysieren. Die RpcStringBindingParse--Funktion gibt den Objekt-UUID-Teil und die Adressteile einer Zeichenfolgenbindung als separate Zeichenfolgen zurück.

Syntax

RPC_STATUS RpcStringBindingParseA(
  RPC_CSTR StringBinding,
  RPC_CSTR *ObjUuid,
  RPC_CSTR *Protseq,
  RPC_CSTR *NetworkAddr,
  RPC_CSTR *Endpoint,
  RPC_CSTR *NetworkOptions
);

Parameter

StringBinding

Zeiger auf eine null-terminated string representation of a binding.

ObjUuid

Gibt einen Zeiger auf einen Zeiger auf einen NULL--terminated string representation of an object UUIDzurück.

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

Protseq

Gibt einen Zeiger auf einen Zeiger auf einen NULL--terminated string representation of a protocol sequence zurück. Eine Liste der von Microsoft RPC unterstützten Protokollsequenzen finden Sie unter Zeichenfolgenbindung.

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

NetworkAddr

Gibt einen Zeiger auf einen Zeiger auf einen null-terminated string representation of a network address zurück. Geben Sie einen NULL- Wert an, um zu verhindern, dass RpcStringBindingParse- den NetworkAddr Parameter zurückgibt. In diesem Fall ruft die Anwendung RpcStringFree-nicht auf.

Endpoint

Gibt einen Zeiger auf einen Zeiger auf einen Null--terminated-Zeichenfolgendarstellung eines Endpunkts zurück. Geben Sie einen NULL- Wert an, um zu verhindern, dass RpcStringBindingParse- den EndPoint--Parameter zurückgibt. In diesem Fall ruft die Anwendung RpcStringFree-nicht auf.

NetworkOptions

Gibt einen Zeiger auf einen Zeiger auf einen NULL--terminated string representation of network options zurück.

Geben Sie einen NULL--Wert an, um zu verhindern, dass RpcStringBindingParse den NetworkOptions-parameter zurückgibt. In diesem Fall ruft die Anwendung RpcStringFree-nicht auf.

Rückgabewert

Wert	Bedeutung
RPC_S_OK	Der Aufruf war erfolgreich.
RPC_S_INVALID_STRING_BINDING	Die Zeichenfolgenbindung ist ungültig.

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

Bemerkungen

Eine Anwendung ruft RpcStringBindingParse Routine auf, um eine Zeichenfolgendarstellung eines Bindungshandles in die zugehörigen Komponentenfelder zu analysieren.

Die RPC-Laufzeitbibliothek weist Speicher für jede zurückgegebene Komponentenzeichenfolge zu. Die Anwendung ist dafür verantwortlich, RpcStringFree einmal für jede zurückgegebene Zeichenfolge aufzurufen, um den Speicher für diese Zeichenfolge zu verwalten.

Wenn ein Feld des StringBinding--Parameters leer ist, gibt RpcStringBindingParse eine leere Zeichenfolge (\0) im entsprechenden Ausgabeparameter zurück.

Hinweis Um die Adresse eines Clients abzufragen, startet eine Anwendung mit dem Aufrufen der RpcBindingServerFromClient-Funktion, um ein teilweise gebundenes Serverbindungshandle abzurufen. Das Serverbindungshandle kann verwendet werden, um eine Zeichenfolgenbindung durch Aufrufen von RpcBindingToStringBinding abzurufen. Der Server kann dann RpcStringBindingParse aufrufen, um die Netzwerkadresse des Clients aus der Zeichenfolgenbindung zu extrahieren.

Anmerkung

Der header rpcdce.h definiert RpcStringBindingParse 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 [Desktop-Apps \| UWP-Apps]
mindestens unterstützte Server-	Windows 2000 Server [Desktop-Apps \| UWP-Apps]
Zielplattform-	Fenster
Header-	rpcdce.h (include Rpc.h)
Library	Rpcrt4.lib
DLL-	Rpcrt4.dll

Siehe auch

RpcBindingFromStringBinding

RpcBindingToStringBinding-

RpcStringBindingCompose-

RpcStringFree-

Freigeben über