Compartir a través de

Función RpcBindingFromStringBindingW (rpcdce.h)

  • Artículo

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

Sintaxis

RPC_STATUS RpcBindingFromStringBindingW(
  RPC_WSTR           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 protocolos no se admite en este host.
RPC_S_INVALID_RPC_PROTSEQ
 La secuencia de protocolos 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, vea rpc Return Values.
 

Observaciones

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 objeto UUID. En este caso, el enlace devuelto contiene un UUID nulo. Si el parámetro stringBinding proporcionado no contiene un campo de punto de conexión, 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 de 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 termine 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.

Nota

El encabezado rpcdce.h define RpcBindingFromStringBinding como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito Valor
cliente mínimo admitido Windows 2000 Professional [aplicaciones de escritorio | Aplicaciones para UWP]
servidor mínimo admitido Windows 2000 Server [aplicaciones de escritorio | Aplicaciones para UWP]
de la plataforma de destino de Windows
encabezado de rpcdce.h (include Rpc.h)
biblioteca de Rpcrt4.lib
DLL de Rpcrt4.dll

Consulte también

RpcBindingCopy

RpcBindingFree

rpcBindingToStringBinding

RpcStringBindingCompose