Función RpcBindingFromStringBinding (rpcdce.h)

La función RpcBindingFromStringBinding devuelve un identificador de enlace de una representación de cadena de un identificador de enlace.

Sintaxis

RPC_STATUS RpcBindingFromStringBinding(
  RPC_CSTR           StringBinding,
  RPC_BINDING_HANDLE *Binding
);

Parámetros

StringBinding

Puntero a una representación de cadena de un identificador de enlace.

Binding

Devuelve un puntero al identificador de enlace del servidor.

Valor devuelto

Valor	Significado
RPC_S_OK	La llamada se realizó correctamente.
RPC_S_INVALID_STRING_BINDING	El enlace de cadena no es válido.
RPC_S_PROTSEQ_NOT_SUPPORTED	La secuencia de protocolo no se admite en este host.
RPC_S_INVALID_RPC_PROTSEQ	La secuencia de protocolo no es válida.
RPC_S_INVALID_ENDPOINT_FORMAT	El formato del punto de conexión no es válido.
RPC_S_STRING_TOO_LONG	Cadena demasiado larga.
RPC_S_INVALID_NET_ADDR	La dirección de red no es válida.
RPC_S_INVALID_ARG	El argumento no era válido.
RPC_S_INVALID_NAF_ID	El identificador de familia de direcciones de red no es válido.

 

Nota Para obtener una lista de códigos de error válidos, consulte Rpc Return Values.

 

Comentarios

La función RpcBindingFromStringBinding crea un identificador de enlace de servidor a partir de una representación de cadena de un identificador de enlace. El parámetro StringBinding no tiene que contener un UUID de objeto. En este caso, el enlace devuelto contiene un UUID nulo. Si el parámetro StringBinding proporcionado no contiene un campo de extremo, el parámetro Binding devuelto es un identificador de enlace enlazado parcialmente. Si el parámetro StringBinding proporcionado contiene un campo de punto de conexión, el punto de conexión se considera un punto de conexión conocido. Si el parámetro StringBinding proporcionado no contiene un campo de dirección de host, el parámetro Binding devuelto hace referencia al host local.

Una aplicación crea un enlace de cadena llamando a la función RpcStringBindingCompose o proporcionando una constante de cadena de caracteres. La creación de un enlace de cadena por este método no implica el contacto con el servidor. El éxito o el error de la API no indicarán la disponibilidad del servidor.

Cuando una aplicación termina de usar el parámetro Binding , la aplicación debe llamar a la función RpcBindingFree para liberar la memoria utilizada por el identificador de enlace.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows 2000 Server [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	rpcdce.h (incluir Rpc.h)
Library	Rpcrt4.lib
Archivo DLL	Rpcrt4.dll

Consulte también

RpcBindingCopy

RpcBindingFree

RpcBindingToStringBinding

RpcStringBindingCompose