Función RpcStringBindingComposeW (rpcdce.h)
La función RpcStringBindingCompose crea un identificador de enlace de cadena.
Sintaxis
RPC_STATUS RpcStringBindingComposeW(
RPC_WSTR ObjUuid,
RPC_WSTR ProtSeq,
RPC_WSTR NetworkAddr,
RPC_WSTR Endpoint,
RPC_WSTR Options,
RPC_WSTR *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 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. 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 impedir 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 para el nombre del servidor para la secuencia de protocolo ncacn_np aparece como \\servername y la cadena C real de un nombre de canalización aparece como \pipe\pipename.
Nota
El encabezado rpcdce.h define RpcStringBindingCompose 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.
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 (include Rpc.h) |
Library | Rpcrt4.lib |
Archivo DLL | Rpcrt4.dll |
Consulte también
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de