RpcStringBindingParseW-Funktion (rpcdce.h)

Artikel
08/25/2023

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 ihre Komponentenfelder zu analysieren. Die RpcStringBindingParse-Funktion gibt den Objekt-UUID-Teil und die Adressteile einer Zeichenfolgenbindung als separate Zeichenfolgen zurück.

Syntax

RPC_STATUS RpcStringBindingParseW(
  RPC_WSTR StringBinding,
  RPC_WSTR *ObjUuid,
  RPC_WSTR *Protseq,
  RPC_WSTR *NetworkAddr,
  RPC_WSTR *Endpoint,
  RPC_WSTR *NetworkOptions
);

Parameter

StringBinding

Zeiger auf eine NULL-beendete Zeichenfolgendarstellung einer Bindung.

ObjUuid

Gibt einen Zeiger auf einen Zeiger auf eine null-beendete Zeichenfolgendarstellung einer Objekt-UUID zurü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 eine NULL-beendete Zeichenfolgendarstellung einer Protokollsequenz 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 eine NULL-beendete Zeichenfolgendarstellung einer Netzwerkadresse 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 eine NULL-beendete 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 eine NULL-beendete Zeichenfolgendarstellung von Netzwerkoptionen 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 der gültigen Fehlercodes finden Sie unter RPC-Rückgabewerte.

Hinweise

Eine Anwendung ruft die RpcStringBindingParse-Routine auf, um eine Zeichenfolgendarstellung eines Bindungshandles in ihre Komponentenfelder zu analysieren.

Die RPC-Laufzeitbibliothek weist arbeitsspeicher für jede zurückgegebene Komponentenzeichenfolge zu. Die Anwendung ist dafür verantwortlich , RpcStringFree einmal für jede zurückgegebene Zeichenfolge aufzurufen, um die Zuordnung des Arbeitsspeichers für diese Zeichenfolge zu beheben.

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

Hinweis

Der rpcdce.h-Header 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 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 [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

RpcBindingToStringBinding

RpcStringBindingCompose

RpcStringFree

Share via