Função RpcBindingFromStringBindingW (rpcdce.h)
A função RpcBindingFromStringBinding retorna um identificador de associação de uma representação de cadeia de caracteres de um identificador de associação.
Sintaxe
RPC_STATUS RpcBindingFromStringBindingW(
RPC_WSTR StringBinding,
RPC_BINDING_HANDLE *Binding
);
Parâmetros
StringBinding
Ponteiro para uma representação de cadeia de caracteres de um identificador de associação.
Binding
Retorna um ponteiro para o identificador de associação do servidor.
Valor retornado
| Valor | Significado |
|---|---|
|
A chamada foi bem-sucedida. |
|
A associação de cadeia de caracteres não é válida. |
|
Não há suporte para a sequência de protocolos neste host. |
|
A sequência de protocolo não é válida. |
|
O formato do ponto de extremidade não é válido. |
|
A cadeia de caracteres é muito longa. |
|
O endereço de rede não é válido. |
|
O argumento não era válido. |
|
O identificador da família de endereços de rede não é válido. |
Comentários
A função RpcBindingFromStringBinding cria um identificador de associação de servidor a partir de uma representação de cadeia de caracteres de um identificador de associação. O parâmetro StringBinding não precisa conter um UUID de objeto. Nesse caso, a associação retornada contém uma UUID nula. Se o parâmetro StringBinding fornecido não contiver um campo de ponto de extremidade, o parâmetro Binding retornado será um identificador de associação parcialmente associado. Se o parâmetro StringBinding fornecido contiver um campo de ponto de extremidade, o ponto de extremidade será considerado um ponto de extremidade conhecido. Se o parâmetro StringBinding fornecido não contiver um campo de endereço de host, o parâmetro Binding retornado fará referência ao host local.
Um aplicativo cria uma associação de cadeia de caracteres chamando a função RpcStringBindingCompose ou fornecendo uma constante de cadeia de caracteres. A criação de uma associação de cadeia de caracteres por esse método não envolve o contato com o servidor. Êxito ou falha da API não indicará a disponibilidade do servidor.
Quando um aplicativo terminar de usar o parâmetro Binding , o aplicativo deverá chamar a função RpcBindingFree para liberar a memória usada pelo identificador de associação.
Observação
O cabeçalho rpcdce.h define RpcBindingFromStringBinding como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.
Requisitos
| 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 |