Função RpcNsBindingExportPnPA (rpcnsi.h)
A função RpcNsBindingExportPnP
Sintaxe
RPC_STATUS RpcNsBindingExportPnPA(
unsigned long EntryNameSyntax,
RPC_CSTR 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 |
---|---|
|
A chamada foi bem-sucedida. |
|
Não havia nada para exportar. |
|
O identificador de associação era inválido. |
|
Este foi o tipo errado de associação para a operação. |
|
A sintaxe de nome é inválida. |
|
A sintaxe de nome não tem suporte. |
|
O nome está incompleto. |
|
Nenhum privilégio para a operação de name-service. |
|
O serviço de nome não está disponível. |
Observações
A função RpcNsBindingExportPnP
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 |