Função RpcNsBindingLookupBeginA (rpcnsi.h)

A função RpcNsBindingLookupBegin cria um contexto de pesquisa para uma interface e um objeto.

Observação Essa função não tem suporte no Windows Vista e em sistemas operacionais posteriores.

 

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 na entrada de valor do Registro HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntax, forneça um valor de RPC_C_NS_SYNTAX_DEFAULT.

EntryName

Ponteiro para um nome de entrada no qual a pesquisa por 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ão garantidas apenas como sendo 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 uma UUID diferente de zero, os identificadores de associação compatíveis sã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 nulo.

BindingMaxCount

Número máximo de associações a serem retornadas no parâmetro BindingVec da função RpcNsBindingLookupNext.

Especifique um valor igual a zero para usar a contagem padrão de RPC_C_BINDING_MAX_COUNT_DEFAULT.

LookupContext

Retorna um ponteiro para um identificador de nome-serviço para uso com as funções RpcNsBindingLookupNext e RpcNsBindingLookupDone.

Valor de retorno

Valor	Significado
RPC_S_OK	A chamada foi bem-sucedida.
RPC_S_INVALID_NAME_SYNTAX	A sintaxe de nome é inválida.
RPC_S_UNSUPPORTED_NAME_SYNTAX	A sintaxe de nome não tem suporte.
RPC_S_INCOMPLETE_NAME	O nome está incompleto.
RPC_S_ENTRY_NOT_FOUND	A entrada nome-serviço não foi encontrada.
RPC_S_NAME_SERVICE_UNAVAILABLE	O serviço de nome não está disponível.
RPC_S_INVALID_OBJECT	Objeto inválido.

 

Observação Para obter uma lista de códigos de erro válidos, consulte RPC Return Values.

 

Observações

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.

A partir do Windows 2000, o ambiente RPC usa o Active Directory como seu banco de dados de serviço de nome 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.

Quando terminar de localizar identificadores de associação, o aplicativo cliente chama a função RpcNsBindingLookupDone para excluir o contexto de pesquisa.

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	rpcnsi.h (inclua Rpc.h)
biblioteca	Rpcns4.lib
de DLL	Rpcns4.dll

Consulte também

RpcNsBindingLookupDone

RpcNsBindingLookupNext