Compartilhar via

Função RpcNsProfileEltInqBeginA (rpcnsi.h)

  • Artigo

A função RpcNsProfileEltInqBegin cria um contexto de consulta para exibir os elementos em um perfil.

Nota Não há suporte para essa função no Windows Vista e em sistemas operacionais posteriores.
 

Sintaxe

RPC_STATUS RpcNsProfileEltInqBeginA(
  unsigned long ProfileNameSyntax,
  RPC_CSTR      ProfileName,
  unsigned long InquiryType,
  RPC_IF_ID     *IfId,
  unsigned long VersOption,
  unsigned long MemberNameSyntax,
  RPC_CSTR      MemberName,
  RPC_NS_HANDLE *InquiryContext
);

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 a ser exibido.

InquiryType

Tipo de consulta a ser executada no perfil. A tabela a seguir lista os tipos de consulta válidos.

Tipo de consulta Significado
RPC_C_PROFILE_DEFAULT_ELT
 Pesquisa o perfil para o elemento de perfil padrão, se houver. Os parâmetros IfId, VersOption e MemberName são ignorados.
RPC_C_PROFILE_ALL_ELTS
 Retorna todos os elementos do perfil. Os parâmetros IfId, VersOption e MemberName são ignorados.
RPC_C_PROFILE_MATCH_BY_IF
 Pesquisa no perfil elementos que contêm a identificação de interface especificada por IfId e VersOption. O parâmetro MemberName é ignorado.
RPC_C_PROFILE_MATCH_BY_MBR
 Pesquisa no perfil elementos que contêm MemberName. Os parâmetros IfId e VersOption são ignorados.
RPC_C_PROFILE_MATCH_BY_BOTH
 Pesquisa no perfil elementos que contêm a identificação da interface e o membro identificados pelos parâmetros IfId, VersOption e MemberName .

IfId

Ponteiro para a identificação da interface dos elementos de perfil a serem retornados pela função RpcNsProfileEltInqNext .

O parâmetro IfId é usado somente ao especificar um valor de RPC_C_PROFILE_MATCH_BY_IF ou RPC_C_PROFILE_MATCH_BY_BOTH para o parâmetro InquiryType . Caso contrário, IfId será ignorado e um valor nulo poderá ser especificado.

VersOption

Especifica como a função RpcNsProfileEltInqNext usa o parâmetro IfId . Esse parâmetro é usado somente ao especificar um valor de RPC_C_PROFILE_MATCH_BY_IF ou RPC_C_PROFILE_MATCH_BY_BOTH para InquiryType. Caso contrário, esse parâmetro será ignorado e um valor 0 poderá ser especificado.

A tabela a seguir descreve valores válidos para VersOption.

Valor Significado
RPC_C_VERS_ALL
 Retorna elementos de perfil que oferecem a interface UUID especificada, independentemente dos números de versão. Para esse valor, especifique 0 para as versões principal e secundária em IfId.
RPC_C_VERS_COMPATIBLE
 Retorna elementos de perfil que oferecem a mesma versão principal da interface UUID especificada e uma versão secundária maior ou igual à versão secundária da interface UUID especificada.
RPC_C_VERS_EXACT
 Retorna elementos de perfil que oferecem a versão especificada da interface UUID especificada.
RPC_C_VERS_MAJOR_ONLY
 Retorna elementos de perfil que oferecem a mesma versão principal da interface UUID especificada (ignora a versão secundária). Para esse valor, especifique 0 para a versão secundária em IfId.
RPC_C_VERS_UPTO
 Retorna elementos de perfil que oferecem uma versão da interface especificada UUID menor ou igual à versão principal e secundária especificada. (Por exemplo, se o IfId continha v2.0 e o perfil continha elementos com V1.3, V2.0 e V2.1, a função RpcNsProfileEltInqNext retorna elementos com V1.3 e V2.0.)

MemberNameSyntax

Sintaxe de MemberName e o parâmetro de retorno MemberName na função RpcNsProfileEltInqNext .

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 membro que a função RpcNsProfileEltInqNext procura em elementos de perfil. O parâmetro MemberName é usado somente ao especificar um valor de RPC_C_PROFILE_MATCH_BY_MBR ou RPC_C_PROFILE_MATCH_BY_BOTH para InquiryType. Caso contrário, MemberName será ignorado e um valor nulo poderá ser especificado.

InquiryContext

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

Valor retornado

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 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 name-service 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 RpcNsProfileEltInqBegin cria um contexto de consulta para exibir os elementos em um perfil.

Usando o parâmetro InquiryType , um aplicativo especifica quais dos seguintes elementos de perfil devem ser retornados de chamadas para RpcNsProfileEltInqNext:

  • O elemento padrão
  • Todos os elementos
  • Elementos com a identificação de interface especificada
  • Elementos com o nome do membro especificado
  • Elementos com a identificação da interface especificada e o nome do membro
Antes de chamar RpcNsProfileEltInqNext, o aplicativo deve primeiro chamar RpcNsProfileEltInqBegin para criar um contexto de consulta.

Quando terminar de exibir os elementos de perfil, o aplicativo chamará a função RpcNsProfileEltInqDone para excluir o contexto de consulta.

Nota 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).
 

Observação

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

RpcIfInqId

RpcNsProfileEltInqDone

RpcNsProfileEltInqNext