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ão garantidas apenas como sendo de uma sequência de protocolo compatível e com suporte e para conter o objeto UUID especificado. O servidor contatado pode não dar suporte à interface desejada.

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.

Quando ObjUuid tem um valor de ponteiro nulo ou uma UUID nula, 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.

ImportContext

Identificador de serviço de nome retornado para uso com as funções RpcNsBindingImportNext e RpcNsBindingImportDone.

Valor de retorno

Observações

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.

Requisitos

Consulte também

RpcNsBindingImportDone

RpcNsBindingImportNext