Função RpcNsMgmtEntryCreateW (rpcnsi.h)

Artigo
11/20/2024

A função RpcNsMgmtEntryCreate cria uma entrada de serviço de nome–banco de dados.

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

Sintaxe

RPC_STATUS RpcNsMgmtEntryCreateW(
  unsigned long EntryNameSyntax,
  RPC_WSTR      EntryName
);

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 da entrada a ser criada.

Valor de retorno

Valor	Significado
RPC_S_OK	A chamada foi bem-sucedida.
RPC_S_INVALID_NAME_SYNTAX	A sintaxe de nome é inválida.
RPC_S_UNSUPPORTED_NAME_SYNTAX	Não há suporte para a sintaxe de nome.
RPC_S_INCOMPLETE_NAME	O nome está incompleto.
RPC_S_ENTRY_ALREADY_EXISTS	A entrada nome-serviço já existe.
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 RpcNsMgmtEntryCreate cria uma entrada no banco de dados de serviço de nome. Um aplicativo de gerenciamento pode chamar RpcNsMgmtEntryCreate para criar uma entrada de serviço de nome–banco de dados para uso por outro aplicativo que não tem o serviço de nome necessário– privilégios de banco de dados para criar uma entrada.

Observação o Windows 2000 Active Directory dá suporte a essa função. Versões anteriores do Windows NT dão suporte apenas ao uso dessa função com o CDS (Serviço de Diretório de Células).

Nota

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

RpcNsMgmtEntryDelete

Compartilhar via