Função RpcNsBindingLookupBeginA (rpcnsi.h)
A função RpcNsBindingLookupBegin cria um contexto de pesquisa para uma interface e um objeto.
Sintaxe
RPC_STATUS RpcNsBindingLookupBeginA(
unsigned long EntryNameSyntax,
RPC_CSTR EntryName,
RPC_IF_HANDLE IfSpec,
UUID *ObjUuid,
unsigned long BindingMaxCount,
RPC_NS_HANDLE *LookupContext
);
Parâmetros
EntryNameSyntax
Sintaxe do parâmetro EntryName .
Para usar a sintaxe especificada no HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntaxde entrada de valor do Registro, forneça um valor de RPC_C_NS_SYNTAX_DEFAULT.
EntryName
Ponteiro para um nome de entrada no qual a pesquisa de associações 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 gerada por Stub que indica a interface a ser pesquisada. 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 objeto UUID especificado. Talvez não haja suporte para a interface desejada pelo servidor contatado.
ObjUuid
Ponteiro para um objeto opcional UUID.
Para um UUID diferente de zero, os identificadores de associação compatíveis serão retornados de uma entrada somente se o servidor tiver exportado o objeto UUID especificado.
Para um valor de ponteiro nulo ou uma UUID nula para esse parâmetro, as alças de associação retornadas contêm um dos UUIDs de 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 uma UUID de objeto zero.
BindingMaxCount
Número máximo de associações a serem retornadas no parâmetro BindingVec da função RpcNsBindingLookupNext .
Especifique um valor zero para usar a contagem padrão de RPC_C_BINDING_MAX_COUNT_DEFAULT.
LookupContext
Retorna um ponteiro para um identificador nome-serviço para uso com as funções RpcNsBindingLookupNext e RpcNsBindingLookupDone .
Valor retornado
| Valor | Significado |
|---|---|
|
A chamada foi bem-sucedida. |
|
A sintaxe do nome é inválida. |
|
A sintaxe do nome não tem suporte. |
|
O nome está incompleto. |
|
A entrada nome-serviço não foi encontrada. |
|
O serviço de nome não está disponível. |
|
Objeto inválido. |
Comentários
A função RpcNsBindingLookupBegin cria um contexto de pesquisa para localizar identificadores de associação compatíveis com o cliente para servidores que oferecem a interface e o objeto especificados.
Antes de chamar RpcNsBindingLookupNext, o aplicativo cliente deve primeiro chamar RpcNsBindingLookupBegin para criar um contexto de pesquisa. Os parâmetros para essa função controlam a operação da função RpcNsBindingLookupNext .
Com efeito com o Windows 2000, o ambiente RPC usa o Active Directory como seu banco de dados name-service e a ordem na qual o ambiente de tempo de execução executa a pesquisa é a seguinte:
- Pesquise no cache local.
- Se a entrada não for encontrada no cache local, pesquise o Active Directory desse computador.
- Se a entrada não for encontrada no computador local, envie solicitações de transmissão para todos os outros serviços do Active Directory no domínio.
Observe que, se a entrada existir no Active Directory, mas não houver informações associadas à entrada, o ambiente de tempo de execução não emitirá essa solicitação de transmissão.
Observação
O cabeçalho rpcnsi.h define RpcNsBindingLookupBegin 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 |