Função RpcStringBindingCompose (rpcdce.h)
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.
Valor retornado
| Valor | Significado |
|---|---|
|
A chamada foi bem-sucedida. |
|
A representação de cadeia de caracteres da UUID não é válida. |
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 |