Función RpcStringBindingCompose (rpcdce.h)

  • Artículo

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

Sintaxis

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

Parámetros

ObjUuid

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

ProtSeq

Puntero a una representación de cadena terminada en null de una secuencia de protocolo. Vea la Nota.

NetworkAddr

Puntero a una representación de cadena terminada en null de una dirección de red. El formato de dirección de red está asociado a la secuencia de protocolo. Vea la Nota.

Endpoint

Puntero a una representación de cadena terminada en null de un punto de conexión. El formato del punto de conexión y el contenido están asociados a la secuencia de protocolo. 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. Vea la Nota.

Options

Puntero a una representación de cadena terminada en null de las opciones de red. La cadena de opción está asociada a la secuencia de protocolo. Vea la Nota.

StringBinding

Devuelve un puntero a un puntero a una representación de cadena terminada en null 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. Vea la Nota.

Nota Para obtener más información, vea Enlace de cadenas.
 

Valor devuelto

Valor Significado
RPC_S_OK
 La llamada se realizó correctamente.
RPC_S_INVALID_STRING_UUID
 La representación de cadena del UUID no es válida.
 
Nota Para obtener una lista de códigos de error válidos, consulte Rpc Return Values.
 

Comentarios

Una aplicación llama a la 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 rpc asigna memoria para la cadena devuelta en el parámetro StringBinding . 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 para la secuencia de protocolo de ncacn_np aparece como \\servername y la cadena C real de un nombre de canalización aparece como \pipe\pipename.

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

RpcBindingFromStringBinding

RpcBindingToStringBinding

RpcStringBindingParse

RpcStringFree