RpcStringBindingCompose function (rpcdce.h)
The RpcStringBindingCompose function creates a string binding handle.
RPC_STATUS RpcStringBindingCompose( RPC_CSTR ObjUuid, RPC_CSTR ProtSeq, RPC_CSTR NetworkAddr, RPC_CSTR Endpoint, RPC_CSTR Options, RPC_CSTR *StringBinding );
Pointer to a null-terminated string representation of an object UUID. For example, the string 6B29FC40-CA47-1067-B31D-00DD010662DA represents a valid UUID.
Pointer to a null-terminated string representation of a protocol sequence. See Note.
Pointer to a null-terminated string representation of a network address. The network-address format is associated with the protocol sequence. See Note.
Pointer to a null-terminated string representation of an endpoint. The endpoint format and content are associated with the protocol sequence. For example, the endpoint associated with the protocol sequence ncacn_np is a pipe name in the format \pipe\pipename. See Note.
Pointer to a null-terminated string representation of network options. The option string is associated with the protocol sequence. See Note.
Returns a pointer to a pointer to a null-terminated string representation of a binding handle.
Specify a NULL value to prevent RpcStringBindingCompose from returning the StringBinding parameter. In this case, the application does not call RpcStringFree. See Note.
||The call succeeded.|
||The string representation of the UUID is not valid.|
An application calls RpcStringBindingCompose routine to combine an object UUID, a protocol sequence, a network address, an endpoint and other network options into a string representation of a binding handle.
The RPC run-time library allocates memory for the string returned in the StringBinding parameter. The application is responsible for calling RpcStringFree to deallocate that memory.
Specify a null parameter value or provide an empty string (\0) for each input string that has no data.
Literal backslash characters within C-language strings must be quoted. The actual C string for the server name for the ncacn_np protocol sequence appears as \\servername, and the actual C string for a pipe name appears as \pipe\pipename.
|Minimum supported client||Windows 2000 Professional [desktop apps | UWP apps]|
|Minimum supported server||Windows 2000 Server [desktop apps | UWP apps]|
|Header||rpcdce.h (include Rpc.h)|