Función RpcStringBindingComposeA (rpcdce.h)

La función RpcStringBindingCompose crea un identificador de enlace de cadena.

Sintaxis

RPC_STATUS RpcStringBindingComposeA(
  RPC_CSTR ObjUuid,
  RPC_CSTR ProtSeq,
  RPC_CSTR NetworkAddr,
  RPC_CSTR Endpoint,
  RPC_CSTR Options,
  RPC_CSTR *StringBinding
);

Parámetros

ObjUuid

Puntero a un representación de cadena terminadanull de un objeto UUID. Por ejemplo, la cadena 6B29FC40-CA47-1067-B31D-00DD010662DA representa un UUID válido.

ProtSeq

Puntero a un una representación de cadena terminada en nullde una secuencia de protocolo. Consulte Nota.

NetworkAddr

Puntero a un nullrepresentación de cadena terminada de una dirección de red. El formato de dirección de red está asociado a la secuencia de protocolos. Consulte Nota.

Endpoint

Puntero a un una representación de cadena terminadanull de un punto de conexión. El formato y el contenido del punto de conexión están asociados a la secuencia de protocolos. Por ejemplo, el punto de conexión asociado a la secuencia de protocolo ncacn_np es un nombre de canalización con el formato \pipe\pipename. Consulte Nota.

Options

Puntero a un nullrepresentación de cadena terminada en las opciones de red. La cadena de opción está asociada a la secuencia de protocolos. Consulte Nota.

StringBinding

Devuelve un puntero a un puntero a un una representación de cadena terminadanull de un identificador de enlace.

Especifique un valor NULL para evitar que rpcStringBindingCompose devuelva el parámetro StringBinding. En este caso, la aplicación no llama a RpcStringFree. Consulte Nota.

Valor devuelto

Observaciones

Una aplicación llama a rutina rpcStringBindingCompose para combinar un UUID de objeto, una secuencia de protocolo, una dirección de red, un punto de conexión y otras opciones de red en una representación de cadena de un identificador de enlace.

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 RpcStringFree para desasignar esa memoria.

Especifique un valor de parámetro null o proporcione una cadena vacía (\0) para cada cadena de entrada que no tenga datos.

Los caracteres de barra diagonal inversa literales dentro de las cadenas del lenguaje C deben estar entre comillas. La cadena C real del nombre del servidor de la secuencia de protocolo de ncacn_np aparece como \\nombreServidor y la cadena C real de un nombre de canalización aparece como \pipe\pipename.

Requisitos

Consulte también

rpcBindingFromStringBinding

rpcBindingToStringBinding

rpcStringBindingParse

RpcStringFree