Freigeben über


RpcStringBindingParse-Funktion (rpcdce.h)

Die RpcStringBindingParse-Funktion gibt den UUID-Teil des Objekts 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 UUID-Teil des Objekts und die Adressteile einer Zeichenfolgenbindung als separate Zeichenfolgen zurück.

Syntax

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

Parameter

StringBinding

Zeiger auf eine NULL-beendete Zeichenfolgendarstellung einer Bindung.

ObjUuid

Gibt einen Zeiger auf einen Zeiger auf eine null-endende 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-endende 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-endende Zeichenfolgendarstellung einer Netzwerkadresse zurück. Geben Sie einen NULL-Wert an, um zu verhindern , dass RpcStringBindingParse den Parameter NetworkAddr zurückgibt. In diesem Fall ruft die Anwendung RpcStringFree nicht auf.

Endpoint

Gibt einen Zeiger auf einen Zeiger auf eine NULL-endende 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-endende Zeichenfolgendarstellung von Netzwerkoptionen zurück.

Geben Sie einen NULL-Wert an, um zu verhindern, dass RpcStringBindingParse den Parameter NetworkOptions 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 die zugehörigen Komponentenfelder zu analysieren.

Die RPC-Laufzeitbibliothek ordnet 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 aufzugeben.

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 durch Aufrufen von RpcBindingToStringBinding abzurufen. 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 (rpc.h einschließen)
Bibliothek Rpcrt4.lib
DLL Rpcrt4.dll

Weitere Informationen

RpcBindingFromStringBinding

RpcBindingToStringBinding

RpcStringBindingCompose

RpcStringFree