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

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.

Requisitos

Consulte también

RpcBindingFromStringBinding

RpcBindingToStringBinding

RpcStringBindingCompose

RpcStringFree