Função RpcNsProfileEltAddA (rpcnsi.h)

A função RpcNsProfileEltAdd adiciona um elemento a um perfil. Se necessário, ele cria a entrada.

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

 

Sintaxe

RPC_STATUS RpcNsProfileEltAddA(
  unsigned long ProfileNameSyntax,
  RPC_CSTR      ProfileName,
  RPC_IF_ID     *IfId,
  unsigned long MemberNameSyntax,
  RPC_CSTR      MemberName,
  unsigned long Priority,
  RPC_CSTR      Annotation
);

Parâmetros

ProfileNameSyntax

Sintaxe de ProfileName.

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.

ProfileName

Ponteiro para o nome do perfil para receber um novo elemento.

IfId

Ponteiro para a identificação da interface do novo elemento de perfil. Para adicionar ou substituir o elemento de perfil padrão, especifique um valor nulo.

MemberNameSyntax

Sintaxe de MemberName.

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.

MemberName

Ponteiro para um nome de serviço – nome de entrada a ser incluído no novo elemento de perfil.

Priority

Valor inteiro (0 a 7) que indica a prioridade relativa para usar o novo elemento de perfil durante as operações de importação e pesquisa. Um valor de 0 é a prioridade mais alta; um valor de 7 é a prioridade mais baixa. Ao adicionar um membro de perfil padrão, use um valor de 0.

Annotation

Ponteiro para uma cadeia de caracteres de anotação armazenada como parte do novo elemento de perfil. Especifique um valor nulo ou uma cadeia de caracteres terminada em nulo se não houver nenhuma cadeia de caracteres de anotação.

A cadeia de caracteres é usada apenas por aplicativos para fins informativos. Por exemplo, um aplicativo pode usar essa cadeia de caracteres para armazenar a cadeia de caracteres de nome de interface especificada no arquivo IDL. O RPC não usa a cadeia de caracteres de anotação durante operações de pesquisa ou importação ou para enumerar elementos de perfil.

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_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 RpcNsProfileEltAdd adiciona um elemento ao atributo de perfil da entrada nome-serviço especificada por ProfileName. Se a entrada ProfileName não existir, RpcNsProfileEltAdd tentar criar a entrada com um atributo de perfil e adicionar o elemento de perfil especificado pelos parâmetros IfId, MemberName, Prioritye Annotation. Nesse caso, o aplicativo deve ter o privilégio de criar a entrada. Caso contrário, um aplicativo de gerenciamento com os privilégios necessários deve criar a entrada chamando a função RpcNsMgmtEntryCreate antes que o aplicativo seja executado.

Se um elemento com o nome do membro especificado e a identificação da interface já estiverem no perfil, RpcNsProfileEltAdd atualizará a prioridade e a cadeia de anotações do elemento usando os valores fornecidos nos parâmetros de Prioridade e Anotação.

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 RpcNsProfileEltAdd 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

RpcIfInqId

RpcNsMgmtEntryCreate

RpcNsProfileEltRemove