RpcStringBindingCompose-Funktion (rpcdce.h)

Die RpcStringBindingCompose-Funktion erstellt ein Zeichenfolgenbindungshandle.

Syntax

RPC_STATUS RpcStringBindingCompose(
  RPC_CSTR ObjUuid,
  RPC_CSTR ProtSeq,
  RPC_CSTR NetworkAddr,
  RPC_CSTR Endpoint,
  RPC_CSTR Options,
  RPC_CSTR *StringBinding
);

Parameter

ObjUuid

Zeiger auf eine NULL-beendete Zeichenfolgendarstellung einer Objekt-UUID. Die Zeichenfolge 6B29FC40-CA47-1067-B31D-00DD010662DA stellt beispielsweise eine gültige UUID dar.

ProtSeq

Zeiger auf eine Null-endende Zeichenfolgendarstellung einer Protokollsequenz. Siehe Hinweis.

NetworkAddr

Zeiger auf eine NULL-endende Zeichenfolgendarstellung einer Netzwerkadresse. Das Netzwerkadressenformat ist der Protokollsequenz zugeordnet. Siehe Hinweis.

Endpoint

Zeiger auf eine NULL-endende Zeichenfolgendarstellung eines Endpunkts. Das Endpunktformat und der Inhalt sind der Protokollsequenz zugeordnet. Beispielsweise ist der Endpunkt, der der Protokollsequenz ncacn_np zugeordnet ist, ein Pipename im Format \pipe\pipename. Siehe Hinweis.

Options

Zeiger auf eine Null-endende Zeichenfolgendarstellung von Netzwerkoptionen. Die Optionszeichenfolge ist der Protokollsequenz zugeordnet. Siehe Hinweis.

StringBinding

Gibt einen Zeiger auf einen Zeiger auf eine null-endende Zeichenfolgendarstellung eines Bindungshandles zurück.

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

Hinweis Weitere Informationen finden Sie unter Zeichenfolgenbindung.

 

Rückgabewert

Wert	Bedeutung
RPC_S_OK	Der Aufruf war erfolgreich.
RPC_S_INVALID_STRING_UUID	Die Zeichenfolgendarstellung der UUID ist ungültig.

 

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

 

Hinweise

Eine Anwendung ruft die RpcStringBindingCompose-Routine auf, um eine Objekt-UUID, eine Protokollsequenz, eine Netzwerkadresse, einen Endpunkt und andere Netzwerkoptionen in einer Zeichenfolgendarstellung eines Bindungshandles zu kombinieren.

Die RPC-Laufzeitbibliothek ordnet Arbeitsspeicher für die im StringBinding-Parameter zurückgegebene Zeichenfolge zu. Die Anwendung ist dafür verantwortlich , RpcStringFree aufzurufen, um die Zuordnung dieses Arbeitsspeichers aufzugeben.

Geben Sie einen NULL-Parameterwert an, oder geben Sie eine leere Zeichenfolge (\0) für jede Eingabezeichenfolge an, die keine Daten enthält.

Literale umgekehrte Schrägstrichzeichen in C-Sprachzeichenfolgen müssen in Anführungszeichen gesetzt werden. Die tatsächliche C-Zeichenfolge für den Servernamen für die ncacn_np Protokollsequenz wird als \\Servername angezeigt, und die tatsächliche C-Zeichenfolge für einen Pipenamen wird als \pipe\pipename angezeigt.

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

RpcStringBindingParse

RpcStringFree