Função RpcStringBindingCompose (rpcdce.h)

  • Artigo

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

Sintaxe

RPC_STATUS RpcStringBindingCompose(
  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 caracteres terminada em nulo de um objeto UUID. Por exemplo, a cadeia de caracteres 6B29FC40-CA47-1067-B31D-00DDD010662DA representa uma UUID válida.

ProtSeq

Ponteiro para uma representação de cadeia de caracteres terminada em nulo de uma sequência de protocolo. Consulte a observação.

NetworkAddr

Ponteiro para uma representação de cadeia de caracteres terminada 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 uma representação de cadeia de caracteres terminada em nulo de um ponto de extremidade. O formato e o conteúdo do ponto de extremidade estã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 uma representação de cadeia de caracteres terminada em nulo das 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 uma representação de cadeia de caracteres terminada em nulo de um identificador de associação.

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

Nota Para obter mais informações, consulte Associação de cadeia de caracteres.
 

Valor retornado

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.
 
Nota Para obter uma lista de códigos de erro válidos, consulte RPC Return Values.
 

Comentários

Um aplicativo chama a rotina RpcStringBindingCompose para combinar um 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 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.

Requisitos

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

Confira também

RpcBindingFromStringBinding

RpcBindingToStringBinding

RpcStringBindingParse

RpcStringFree