Share via

Função RpcNsGroupMbrInqBeginA (rpcnsi.h)

  • Artigo

A função RpcNsGroupMbrInqBegin cria um contexto de investigação para exibir membros do grupo.

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

Sintaxe

RPC_STATUS RpcNsGroupMbrInqBeginA(
  unsigned long GroupNameSyntax,
  RPC_CSTR      GroupName,
  unsigned long MemberNameSyntax,
  RPC_NS_HANDLE *InquiryContext
);

Parâmetros

GroupNameSyntax

Sintaxe de GroupName.

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.

GroupName

Ponteiro para o nome do grupo RPC a ser exibido.

MemberNameSyntax

Sintaxe do parâmetro return, MemberName, na função RpcNsGroupMbrInqNext .

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.

InquiryContext

Retorna um ponteiro para um identificador name-service para uso com as funções RpcNsGroupMbrInqNext e RpcNsGroupMbrInqDone .

Valor retornado

Valor Significado
RPC_S_OK
 A chamada foi bem-sucedida.
RPC_S_INVALID_NAME_SYNTAX
 A sintaxe do 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 está indisponível.
 
Nota Para obter uma lista de códigos de erro válidos, consulte RPC Return Values.
 

Comentários

A função RpcNsGroupMbrInqBegin cria um contexto de investigação para exibir os membros de um grupo RPC. Antes de chamar RpcNsGroupMbrInqNext, o aplicativo deve primeiro chamar RpcNsGroupMbrInqBegin para criar um contexto de consulta. Quando terminar de exibir os membros do grupo RPC, o aplicativo chama RpcNsGroupMbrInqDone para excluir o contexto de investigação.

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

Observação

O cabeçalho rpcnsi.h define RpcNsGroupMbrInqBegin como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho rpcnsi.h (inclua Rpc.h)
Biblioteca Rpcns4.lib
DLL Rpcns4.dll

Confira também

RpcNsGroupMbrAdd

RpcNsGroupMbrInqDone

RpcNsGroupMbrInqNext