Función RpcStringBindingCompose (rpcdce.h)
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.
Valor devuelto
| Valor | Significado |
|---|---|
|
La llamada se realizó correctamente. |
|
La representación de cadena del UUID no es válida. |
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 |