Função RpcNsBindingLookupBeginA (rpcnsi.h)

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

Nota 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ó têm garantia de serem de uma sequência de protocolo compatível e com suporte e para conter o UUID do objeto 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 são retornados de uma entrada somente se o servidor tiver exportado o UUID do objeto especificado.

Para um valor de ponteiro nulo ou uma UUID nula para esse parâmetro, os identificadores de associação retornados 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.

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 name-service para uso com as funções RpcNsBindingLookupNext e RpcNsBindingLookupDone .

Valor retornado

Valor Significado
RPC_S_OK
A chamada foi bem-sucedida.
RPC_S_INVALID_NAME_SYNTAX
A sintaxe do 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 está indisponível.
RPC_S_INVALID_OBJECT
Objeto inválido.
 
Nota Para obter uma lista de códigos de erro válidos, consulte RPC Return Values.
 

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 .

Em vigor 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.

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

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

Requisito Valor
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

RpcNsBindingLookupDone

RpcNsBindingLookupNext