Função RpcStringBindingParse (rpcdce.h)

A função RpcStringBindingParse retorna a parte UUID do objeto e as partes de endereço de uma associação de cadeia de caracteres como cadeias de caracteres separadas. Um aplicativo chama RpcStringBindingParse para analisar uma representação de cadeia de caracteres de um identificador de associação em seus campos de componente. A função RpcStringBindingParse retorna a parte UUID do objeto e as partes de endereço de uma associação de cadeia de caracteres como cadeias de caracteres separadas.

Sintaxe

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

Parâmetros

StringBinding

Ponteiro para uma representação de cadeia de caracteres terminada em nulo de uma associação.

ObjUuid

Retorna um ponteiro para um ponteiro para uma representação de cadeia de caracteres terminada em nulo de um objeto UUID.

Especifique um valor NULL para impedir que RpcStringBindingParse retorne o parâmetro ObjectUuid . Nesse caso, o aplicativo não chama RpcStringFree.

Protseq

Retorna um ponteiro para um ponteiro para uma representação de cadeia de caracteres terminada em nulo de uma sequência de protocolo. Para obter uma lista de sequências de protocolo com suporte do Microsoft RPC, consulte Associação de cadeia de caracteres.

Especifique um valor NULL para impedir que RpcStringBindingParse retorne o parâmetro ProtSeq . Nesse caso, o aplicativo não chama RpcStringFree.

NetworkAddr

Retorna um ponteiro para um ponteiro para uma representação de cadeia de caracteres terminada em nulo de um endereço de rede. Especifique um valor NULL para impedir que RpcStringBindingParse retorne o parâmetro NetworkAddr . Nesse caso, o aplicativo não chama RpcStringFree.

Endpoint

Retorna um ponteiro para um ponteiro para uma representação de cadeia de caracteres terminada em nulo de um ponto de extremidade. Especifique um valor NULL para impedir que RpcStringBindingParse retorne o parâmetro EndPoint . Nesse caso, o aplicativo não chama RpcStringFree.

NetworkOptions

Retorna um ponteiro para um ponteiro para uma representação de cadeia de caracteres terminada em nulo de opções de rede.

Especifique um valor NULL para impedir que RpcStringBindingParse retorne o parâmetro NetworkOptions . Nesse caso, o aplicativo não chama RpcStringFree.

Valor retornado

Comentários

Um aplicativo chama a rotina RpcStringBindingParse para analisar uma representação de cadeia de caracteres de um identificador de associação em seus campos de componente.

A biblioteca de tempo de execução RPC aloca memória para cada cadeia de caracteres de componente retornada. O aplicativo é responsável por chamar RpcStringFree uma vez para cada cadeia de caracteres retornada para desalocar a memória dessa cadeia de caracteres.

Se qualquer campo do parâmetro StringBinding estiver vazio, RpcStringBindingParse retornará uma cadeia de caracteres vazia (\0) no parâmetro de saída correspondente.

Requisitos

Confira também

RpcBindingFromStringBinding

RpcBindingToStringBinding

RpcStringBindingCompose

RpcStringFree