Função RpcNsBindingImportBeginA (rpcnsi.h)
A função RpcNsBindingImportBegin cria um contexto de importação para importar identificadores de associação compatíveis com o cliente para servidores que oferecem a interface e o objeto especificados.
Sintaxe
RPC_STATUS RpcNsBindingImportBeginA(
unsigned long EntryNameSyntax,
RPC_CSTR EntryName,
RPC_IF_HANDLE IfSpec,
UUID *ObjUuid,
RPC_NS_HANDLE *ImportContext
);
Parâmetros
EntryNameSyntax
Sintaxe de EntryName.
Para usar a sintaxe especificada na entrada de valor do Registro HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntax, especifique RPC_C_NS_SYNTAX_DEFAULT.
EntryName
Ponteiro para um nome de entrada no qual a pesquisa por identificadores de associação compatíveis começa.
Para usar o nome de entrada especificado na entrada de valor do Registro HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultEntry, forneça um ponteiro nulo ou uma cadeia de caracteres vazia. Nesse caso, o parâmetro EntryNameSyntax é ignorado e a biblioteca em tempo de execução usa a sintaxe padrão.
IfSpec
Estrutura de dados gerada por Stub que indica a interface a ser importada. Se a especificação da interface não tiver sido exportada ou não for de nenhuma preocupação para o chamador, especifique um valor nulo para esse parâmetro. Nesse caso, as associações retornadas só têm garantia de serem de uma sequência de protocolo compatível e com suporte e para conter o UUID do objeto especificado. O servidor contatado pode não dar suporte à interface desejada.
ObjUuid
Ponteiro para um objeto opcional UUID.
Para um UUID diferente de zero, os identificadores de associação compatíveis são retornados de uma entrada somente se o servidor tiver exportado o UUID do objeto especificado.
Quando ObjUuid tem um valor de ponteiro nulo ou uma UUID nula, as alças de associação retornadas contêm um dos UUIDs do objeto exportados pelo servidor compatível. Se o servidor não exportou UUIDs de objeto, os identificadores de associação compatíveis retornados contêm um UUID de objeto nulo.
ImportContext
Identificador nome-serviço retornado para uso com as funções RpcNsBindingImportNext e RpcNsBindingImportDone .
Valor retornado
| Valor | Significado |
|---|---|
|
A chamada foi bem-sucedida. |
|
A sintaxe do nome é inválida. |
|
O nome excede o comprimento máximo. |
|
A sintaxe de nome não tem suporte. |
|
O nome está incompleto. |
|
A entrada nome-serviço não foi encontrada. |
|
O serviço de nome está indisponível. |
|
Objeto inválido. |
Comentários
Antes de chamar a função RpcNsBindingImportNext , o aplicativo cliente deve primeiro chamar RpcNsBindingImportBegin para criar um contexto de importação. Os parâmetros para essa função controlam a operação da função RpcNsBindingImportNext .
Quando terminar de importar identificadores de associação, o aplicativo cliente chama a função RpcNsBindingImportDone para excluir o contexto de importação.
Observação
O cabeçalho rpcnsi.h define RpcNsBindingImportBegin 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 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | rpcnsi.h (inclua Rpc.h) |
| Biblioteca | Rpcns4.lib |
| DLL | Rpcns4.dll |
Confira também
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de