Função RpcNsProfileEltRemoveW (rpcnsi.h)

Artigo
11/20/2024

A função RpcNsProfileEltRemove remove um elemento de um perfil.

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

Sintaxe

RPC_STATUS RpcNsProfileEltRemoveW(
  unsigned long ProfileNameSyntax,
  RPC_WSTR      ProfileName,
  RPC_IF_ID     *IfId,
  unsigned long MemberNameSyntax,
  RPC_WSTR      MemberName
);

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 do qual remover um elemento.

IfId

Ponteiro para a identificação da interface do elemento de perfil a ser removido.

Especifique um valor nulo para remover o membro de perfil padrão.

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 o nome do serviço – nome de entrada no elemento de perfil a ser removido.

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_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.

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

Observações

A função RpcNsProfileEltRemove remove um elemento de perfil do atributo de perfil na entrada ProfileName. Essa função requer uma correspondência exata dos parâmetros MemberName e IfId para remover um elemento de perfil. A entrada (MemberName), incluída como membro no elemento de perfil, não é excluída.

Observação Usar RpcNsProfileEltRemove com cuidado: remover elementos de um perfil pode ter o efeito indesejado de quebrar uma hierarquia de perfis.

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

RpcNsProfileDelete

RpcNsProfileEltAdd

Compartilhar via