The RpcBindingFromStringBinding function returns a binding handle from a string representation of a binding handle.
#include <rpc.h>
RPC_STATUS RPC_ENTRY RpcBindingFromStringBinding(
unsigned char * StringBinding,
RPC_BINDING_HANDLE * Binding
);
The RpcBindingFromStringBinding routine creates a server binding handle from a string representation of a binding handle.
The StringBinding argument does not have to contain an object UUID. In this case, the returned binding contains a nil UUID.
If the provided StringBinding argument does not contain an endpoint field, the returned Binding argument is a partially bound binding handle.
If the provided StringBinding argument contains an endpoint field, the endpoint is considered to be a well-known endpoint.
If the provided StringBinding argument does not contain a host address field, the returned Binding argument references the local host.
An application creates a string binding by calling the RpcStringBindingCompose routine or by providing a character-string constant.
When an application is finished using the Binding argument, the application should call the RpcBindingFree routine to release the memory used by the binding handle.
| Value | Meaning |
|---|---|
| RPC_S_OK | Success |
| RPC_S_INVALID_STRING_BINDING | Invalid string binding |
| RPC_S_PROTSEQ_NOT_SUPPORTED | Protocol sequence not supported on this host |
| RPC_S_INVALID_RPC_PROTSEQ | Invalid protocol sequence |
| RPC_S_INVALID_ENDPOINT_FORMAT | Invalid endpoint format |
| RPC_S_STRING_TOO_LONG | String too long |
| RPC_S_INVALID_NET_ADDR | Invalid network address |
| RPC_S_INVALID_ARG | Invalid argument |
| RPC_S_INVALID_NAF_ID | Invalid network-address-family ID |
Windows NT: Yes
Windows CE: Unsupported.
Header: Declared in rpcdce.h.
Import Library: Link with rpcrt4.lib.
RpcBindingCopy, RpcBindingFree, RpcBindingToStringBinding, RpcStringBindingCompose