Função RpcStringBindingParseA (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 RpcStringBindingParseA(
  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 caracteresnula terminada de uma associação.

ObjUuid

Retorna um ponteiro para um ponteiro para um representação de cadeia de caracteresterminada nula de um objeto UUID.

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

Protseq

Retorna um ponteiro para um ponteiro para um representação de cadeia de caracteres nulaterminada de uma sequência de protocolo. Para obter uma lista de sequências de protocolo compatíveis com o Microsoft RPC, consulte String Binding.

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 um representação de cadeia de caracteres nulaterminada de um endereço de rede. Especifique um valor de 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 um representação de cadeia de caracteres nulaterminada de um ponto de extremidade. Especifique um valor de NULL para impedir que RpcStringBindingParse retorne o parâmetro do EndPoint. Nesse caso, o aplicativo não chama RpcStringFree.

NetworkOptions

Retorna um ponteiro para um ponteiro para um representação de cadeia de caracteres nulaterminada de opções de rede.

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

Valor de retorno

Valor	Significado
RPC_S_OK	A chamada foi bem-sucedida.
RPC_S_INVALID_STRING_BINDING	A associação de cadeia de caracteres é inválida.

 

Observação Para obter uma lista de códigos de erro válidos, consulte RPC Return Values.

 

Observações

Um aplicativo chama rotina de 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.

Observação Para consultar o endereço de um cliente, um aplicativo começa chamando a função RpcBindingServerFromClient para obter um identificador de associação de servidor parcialmente associado. O identificador de associação do servidor pode ser usado para obter uma associação de cadeia de caracteres invocando RpcBindingToStringBinding. Em seguida, o servidor pode chamar RpcStringBindingParse para extrair o endereço de rede do cliente da associação de cadeia de caracteres.

 

Nota

O cabeçalho rpcdce.h define RpcStringBindingParse como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP]
servidor com suporte mínimo	Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP]
da Plataforma de Destino	Windows
cabeçalho	rpcdce.h (inclua Rpc.h)
biblioteca	Rpcrt4.lib
de DLL	Rpcrt4.dll

Consulte também

RpcBindingFromStringBinding

RpcBindingToStringBinding

RpcStringBindingCompose

RpcStringFree