Función RpcBindingToStringBindingA (rpcdce.h)

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

Sintaxis

RPC_STATUS RpcBindingToStringBindingA(
  RPC_BINDING_HANDLE Binding,
  RPC_CSTR           *StringBinding
);

Parámetros

Binding

Identificador de enlace de cliente o servidor para convertir en una representación de cadena de un identificador de enlace.

StringBinding

Devuelve un puntero a un puntero a la representación de cadena del identificador de enlace especificado en el parámetro Binding .

Especifique un valor NULL para evitar que rpcBindingToStringBinding devuelva el parámetro stringBinding . En este caso, la aplicación no llama a la función RpcStringFree.

Valor devuelto

Valor	Significado
RPC_S_OK	La llamada se realizó correctamente.
RPC_S_INVALID_BINDING	El identificador de enlace no era válido.

 

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

 

Observaciones

La función RpcBindingToStringBinding convierte un identificador de enlace de cliente o servidor en su representación de cadena.

La biblioteca en tiempo de ejecución de RPC asigna memoria para la cadena devuelta en el parámetro stringBinding de . La aplicación es responsable de llamar a la función de RpcStringFree para desasignar esa memoria.

Si el identificador de enlace del parámetro Binding contenía un objeto nulo UUID, el campo UUID del objeto no se incluye en la cadena devuelta.

Para analizar el parámetro devuelto stringBinding, llame a la función RpcStringBindingParse.

Nota Para consultar la dirección de un cliente, una aplicación comienza llamando a la función RpcBindingServerFromClient para obtener un identificador de enlace de servidor parcialmente enlazado. El identificador de enlace de servidor se puede usar para obtener un enlace de cadena invocando RpcBindingToStringBinding. A continuación, el servidor puede llamar a RpcStringBindingParse para extraer la dirección de red del cliente del enlace de cadena.

 

Nota

El encabezado rpcdce.h define RpcBindingToStringBinding 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

rpcBindingFromStringBinding

rpcStringBindingParse

RpcStringFree