Función RpcStringBindingParse (rpcdce.h)

La función RpcStringBindingParse devuelve la parte UUID del objeto y las partes de dirección de un enlace de cadena como cadenas independientes. Una aplicación llama a RpcStringBindingParse para analizar una representación de cadena de un identificador de enlace en sus campos de componente. La función RpcStringBindingParse devuelve la parte UUID del objeto y las partes de dirección de un enlace de cadena como cadenas independientes.

Sintaxis

RPC_STATUS RpcStringBindingParse(
  RPC_CSTR StringBinding,
  RPC_CSTR *ObjUuid,
  RPC_CSTR *Protseq,
  RPC_CSTR *NetworkAddr,
  RPC_CSTR *Endpoint,
  RPC_CSTR *NetworkOptions
);

Parámetros

StringBinding

Puntero a una representación de cadena terminada en null de un enlace.

ObjUuid

Devuelve un puntero a un puntero a una representación de cadena terminada en null de un UUID de objeto.

Especifique un valor NULL para impedir que RpcStringBindingParse devuelva el parámetro ObjectUuid . En este caso, la aplicación no llama a RpcStringFree.

Protseq

Devuelve un puntero a un puntero a una representación de cadena terminada en null de una secuencia de protocolo. Para obtener una lista de las secuencias de protocolo compatibles con RPC de Microsoft, consulte Enlace de cadenas.

Especifique un valor NULL para impedir que RpcStringBindingParse devuelva el parámetro ProtSeq . En este caso, la aplicación no llama a RpcStringFree.

NetworkAddr

Devuelve un puntero a un puntero a una representación de cadena terminada en null de una dirección de red. Especifique un valor NULL para impedir que RpcStringBindingParse devuelva el parámetro NetworkAddr . En este caso, la aplicación no llama a RpcStringFree.

Endpoint

Devuelve un puntero a un puntero a una representación de cadena terminada en null de un punto de conexión. Especifique un valor NULL para impedir que RpcStringBindingParse devuelva el parámetro EndPoint . En este caso, la aplicación no llama a RpcStringFree.

NetworkOptions

Devuelve un puntero a un puntero a una representación de cadena terminada en null de las opciones de red.

Especifique un valor NULL para impedir que RpcStringBindingParse devuelva el parámetro NetworkOptions . En este caso, la aplicación no llama a RpcStringFree.

Valor devuelto

Valor	Significado
RPC_S_OK	La llamada se realizó correctamente.
RPC_S_INVALID_STRING_BINDING	El enlace de cadena no es válido.

 

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

 

Comentarios

Una aplicación llama a la rutina RpcStringBindingParse para analizar una representación de cadena de un identificador de enlace en sus campos de componente.

La biblioteca en tiempo de ejecución rpc asigna memoria para cada cadena de componente devuelta. La aplicación es responsable de llamar a RpcStringFree una vez para cada cadena devuelta para desasignar la memoria de esa cadena.

Si algún campo del parámetro StringBinding está vacío, RpcStringBindingParse devuelve una cadena vacía (\0) en el parámetro de salida correspondiente.

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 enlazado parcialmente. 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.

 

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

RpcBindingFromStringBinding

RpcBindingToStringBinding

RpcStringBindingCompose

RpcStringFree