Función RpcBindingFromStringBinding (rpcdce.h)

  • Artículo

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