Função RpcStringBindingComposeA (rpcdce.h)

Artigo
11/20/2024

A função RpcStringBindingCompose cria um identificador de associação de cadeia de caracteres.

Sintaxe

RPC_STATUS RpcStringBindingComposeA(
  RPC_CSTR ObjUuid,
  RPC_CSTR ProtSeq,
  RPC_CSTR NetworkAddr,
  RPC_CSTR Endpoint,
  RPC_CSTR Options,
  RPC_CSTR *StringBinding
);

Parâmetros

ObjUuid

Ponteiro para uma representação de cadeia de caracteresterminada nulo de um objeto UUID. Por exemplo, a cadeia de caracteres 6B29FC40-CA47-1067-B31D-00DD010662DA representa uma UUID válida.

ProtSeq

Ponteiro para um representação de cadeia de caracteresterminada nula de uma sequência de protocolo. Consulte a Observação.

NetworkAddr

Ponteiro para um representação de cadeia de caracteresterminada em nulo de um endereço de rede. O formato de endereço de rede está associado à sequência de protocolo. Consulte a Observação.

Endpoint

Ponteiro para um representação de cadeia de caracteresterminada nula de um ponto de extremidade. O formato e o conteúdo do ponto de extremidade são associados à sequência de protocolo. Por exemplo, o ponto de extremidade associado à sequência de protocolo ncacn_np é um nome de pipe no formato \pipe\pipename. Consulte a Observação.

Options

Ponteiro para um representação de cadeia de caracteresterminada nula de opções de rede. A cadeia de caracteres de opção está associada à sequência de protocolo. Consulte a Observação.

StringBinding

Retorna um ponteiro para um ponteiro para um representação de cadeia de caracteres nulaterminada de um identificador de associação.

Especifique um valor NULL para impedir que RpcStringBindingCompose retornem o parâmetro StringBinding. Nesse caso, o aplicativo não chama RpcStringFree. Consulte a Observação.

Observação Para obter mais informações, consulte string binding.

Valor de retorno

Valor	Significado
RPC_S_OK	A chamada foi bem-sucedida.
RPC_S_INVALID_STRING_UUID	A representação de cadeia de caracteres da UUID não é vá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 RpcStringBindingCompose para combinar uma UUID de objeto, uma sequência de protocolo, um endereço de rede, um ponto de extremidade e outras opções de rede em uma representação de cadeia de caracteres de um identificador de associação.

A biblioteca de tempo de execução do RPC aloca memória para a cadeia de caracteres retornada no parâmetro StringBinding. O aplicativo é responsável por chamar RpcStringFree para desalocar essa memória.

Especifique um valor de parâmetro nulo ou forneça uma cadeia de caracteres vazia (\0) para cada cadeia de caracteres de entrada que não tenha dados.

Caracteres de barra invertida literal dentro de cadeias de caracteres de linguagem C devem ser citados. A cadeia de caracteres C real para o nome do servidor para a sequência de protocolo ncacn_np aparece como \\servername, e a cadeia de caracteres C real para um nome de pipe aparece como \pipe\pipename.

Nota

O cabeçalho rpcdce.h define RpcStringBindingCompose 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

RpcStringBindingParse

RpcStringFree

Compartilhar via