Função RpcNsBindingExportPnPW (rpcnsi.h)

Artigo
11/20/2024

A função RpcNsBindingExportPnP estabelece uma entrada de banco de dados de serviço de nome com vários identificadores de associação e vários objetos para um servidor que dá suporte ao Plug and Play.

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

Sintaxe

RPC_STATUS RpcNsBindingExportPnPW(
  unsigned long EntryNameSyntax,
  RPC_WSTR      EntryName,
  RPC_IF_HANDLE IfSpec,
  UUID_VECTOR   *ObjectVector
);

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, forneça um valor de RPC_C_NS_SYNTAX_DEFAULT.

EntryName

Ponteiro para o nome de entrada para o qual os identificadores de associação e UUIDs de objeto são exportados. Você não pode fornecer uma cadeia de caracteres nula ou vazia.

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 especificando a interface a ser exportada. Um valor nulo indica que não há identificadores de associação para exportar (somente UUIDs de objeto devem ser exportados) e BindingVec é ignorado.

ObjectVector

Ponteiro para um vetor de UUIDs de objeto oferecidos pelo servidor. O aplicativo de servidor constrói esse vetor. Um valor nulo indica que não há UUIDs de objeto para exportar (somente identificadores de associação devem ser exportados).

Valor de retorno

Valor	Significado
RPC_S_OK	A chamada foi bem-sucedida.
RPC_S_NOTHING_TO_EXPORT	Não havia nada para exportar.
RPC_S_INVALID_BINDING	O identificador de associação era inválido.
RPC_S_WRONG_KIND_OF_BINDING	Este foi o tipo errado de associação para a operação.
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_NO_NS_PRIVILEGE	Nenhum privilégio para a operação de name-service.
RPC_S_NAME_SERVICE_UNAVAILABLE	O serviço de nome não está disponível.

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

Observações

A função RpcNsBindingExportPnP permite que um aplicativo de servidor ofereça publicamente uma interface no banco de dados de serviço de nome que dê suporte a associações Plug and Play para uso por qualquer aplicativo cliente.

Observe que o aplicativo de servidor não deve fornecer explicitamente o vetor de associação ao exportar associações Plug and Play. As associações são atualizadas automaticamente quando há uma alteração nas associações devido a um evento Plug and Play.

Nota

O cabeçalho rpcnsi.h define RpcNsBindingExportPnP 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

RpcNsBindingExport

RpcNsBindingUnexportPnP

Compartilhar via