Função RpcNsBindingUnexportPnPA (rpcnsi.h)

Artigo
11/20/2024

A função RpcNsBindingUnexportPnP remove os identificadores de associação para interfaces e objetos Plug and Play de uma entrada no banco de dados name-service.

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

Sintaxe

RPC_STATUS RpcNsBindingUnexportPnPA(
  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 do qual remover identificadores de associação e UUIDs de objeto.

IfSpec

Especificação de interface para os identificadores de associação a serem removidos do banco de dados do serviço de nome. Um valor de parâmetro nulo indica que não é necessário cancelar a exibição de identificadores de associação (somente UUIDs de objeto devem ser não relatadas).

ObjectVector

Ponteiro para um vetor de UUIDs de objeto que o servidor não deseja mais oferecer. O aplicativo constrói esse vetor. Um valor nulo indica que não há UUIDs de objeto para desexportar (somente identificadores de associação devem ser não relatados).

Valor de retorno

Valor	Significado
RPC_S_OK	A chamada foi bem-sucedida.
RPC_S_INVALID_VERS_OPTION	A opção de versão é inválida.
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_INTERFACE_NOT_FOUND	A interface não foi encontrada.
RPC_S_NOT_ALL_OBJS_UNEXPORTED	Nem todos os objetos não são relatados.

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

Observações

A função RpcNsBindingUnexportPnP permite que um aplicativo de servidor remova os identificadores de associação e UUIDs de objeto de recursos compatíveis com Plug and Play de uma entrada de banco de dados do serviço de nome. Um aplicativo de servidor pode desexportar a interface e os objetos especificados em uma única chamada para RpcNsBindingUnexportPnP, ou pode desexportá-los separadamente. Somente os identificadores de associação que correspondem à UUID da interface e aos números de versão da interface principal e secundária encontrados no parâmetro IfSpec não são relatados.

Nota

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

RpcNsBindingExportPnP

RpcNsBindingUnexport

Compartilhar via