Función RpcStringBindingParseW (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 componentes. 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 RpcStringBindingParseW(
  RPC_WSTR StringBinding,
  RPC_WSTR *ObjUuid,
  RPC_WSTR *Protseq,
  RPC_WSTR *NetworkAddr,
  RPC_WSTR *Endpoint,
  RPC_WSTR *NetworkOptions
);

Parámetros

StringBinding

Puntero a un una representación de cadena terminadanull de un enlace.

ObjUuid

Devuelve un puntero a un puntero a un representación de cadena terminadanull de un objeto UUID.

Especifique un valor de NULL para evitar 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 un una representación de cadena terminadanull 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 evitar 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 un nullrepresentación de cadena terminada de una dirección de red. Especifique un valor de NULL para evitar 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 un nullrepresentación de cadena terminada de un punto de conexión. Especifique un valor de NULL para evitar 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 un una representación de cadena terminadanull de las opciones de red.

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

Valor devuelto

Observaciones

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

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