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.
Rückgabewert
| Wert | Bedeutung |
|---|---|
|
Der Aufruf war erfolgreich. |
|
Die Zeichenfolgendarstellung der UUID ist ungültig. |
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 |