Compartir a través de

Función RpcNsProfileEltInqBeginA (rpcnsi.h)

  • Artículo

La función RpcNsProfileEltInqBegin crea un contexto de consulta para ver los elementos de un perfil.

Nota Esta función no se admite en Windows Vista ni en sistemas operativos posteriores.
 

Sintaxis

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

Sintaxis de ProfileName.

Para usar la sintaxis especificada en la entrada de valor del Registro HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntax, proporcione un valor de RPC_C_NS_SYNTAX_DEFAULT.

ProfileName

Puntero al nombre del perfil que se va a ver.

InquiryType

Tipo de consulta que se va a realizar en el perfil. En la tabla siguiente se enumeran los tipos de consulta válidos.

Tipo de consulta Significado
RPC_C_PROFILE_DEFAULT_ELT
 Busca en el perfil el elemento de perfil predeterminado, si existe. Se omiten los parámetros IfId, VersOptiony MemberName.
RPC_C_PROFILE_ALL_ELTS
 Devuelve todos los elementos del perfil. Se omiten los parámetros IfId, VersOptiony MemberName.
RPC_C_PROFILE_MATCH_BY_IF
 Busca en el perfil los elementos que contienen la identificación de la interfaz especificada por IfId y VersOption. Se omite el parámetro MemberName.
RPC_C_PROFILE_MATCH_BY_MBR
 Busca en el perfil los elementos que contienen MemberName. Se omiten los parámetros IfId y VersOption.
RPC_C_PROFILE_MATCH_BY_BOTH
 Busca en el perfil los elementos que contienen la identificación de la interfaz y el miembro identificados por los parámetros ifId, VersOptiony MemberName.

IfId

Puntero a la identificación de la interfaz de los elementos de perfil que devuelve la función de RpcNsProfileEltInqNext.

El parámetro IfId solo se usa al especificar un valor de RPC_C_PROFILE_MATCH_BY_IF o RPC_C_PROFILE_MATCH_BY_BOTH para el parámetro InquiryType. De lo contrario, se omite IfId y se puede especificar un valor NULL.

VersOption

Especifica cómo la función de RpcNsProfileEltInqNext usa el parámetro IfId. Este parámetro solo se usa al especificar un valor de RPC_C_PROFILE_MATCH_BY_IF o RPC_C_PROFILE_MATCH_BY_BOTH para InquiryType. De lo contrario, se omite este parámetro y se puede especificar un valor 0.

En la tabla siguiente se describen los valores válidos de VersOption.

Valor Significado
RPC_C_VERS_ALL
 Devuelve los elementos de perfil que ofrecen el UUID de interfaz especificado, independientemente de los números de versión. Para este valor, especifique 0 para las versiones principales y secundarias de IfId.
RPC_C_VERS_COMPATIBLE
 Devuelve elementos de perfil que ofrecen la misma versión principal del UUID de interfaz especificado y una versión secundaria mayor o igual que la versión secundaria del UUID de interfaz especificado.
RPC_C_VERS_EXACT
 Devuelve elementos de perfil que ofrecen la versión especificada del UUID de interfaz especificado.
RPC_C_VERS_MAJOR_ONLY
 Devuelve los elementos de perfil que ofrecen la misma versión principal del UUID de interfaz especificado (omite la versión secundaria). Para este valor, especifique 0 para la versión secundaria en IfId.
RPC_C_VERS_UPTO
 Devuelve los elementos de perfil que ofrecen una versión del UUID de interfaz especificado menor o igual que la versión principal y secundaria especificada. (Por ejemplo, si el IfId contenía V2.0 y el perfil contenía elementos con V1.3, V2.0 y V2.1, la función rpcNsProfileEltInqNext devuelve elementos con V1.3 y V2.0).

MemberNameSyntax

Sintaxis de MemberNamey el parámetro return MemberName en la función RpcNsProfileEltInqNext .

Para usar la sintaxis especificada en la entrada de valor del Registro HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntax, proporcione un valor de RPC_C_NS_SYNTAX_DEFAULT.

MemberName

Puntero al nombre de miembro que busca la función de RpcNsProfileEltInqNext en los elementos de perfil. El parámetro memberName de solo se usa al especificar un valor de RPC_C_PROFILE_MATCH_BY_MBR o RPC_C_PROFILE_MATCH_BY_BOTH para InquiryType. De lo contrario, se omite memberName y se puede especificar un valor NULL.

InquiryContext

Devuelve un puntero a un identificador de servicio de nombre para su uso con las funciones de RpcNsProfileEltInqNext y RpcNsProfileEltInqDone.

Valor devuelto

Valor Significado
RPC_S_OK
 La llamada se realizó correctamente.
RPC_S_INVALID_VERS_OPTION
 La opción de versión no es válida.
RPC_S_INVALID_NAME_SYNTAX
 La sintaxis de nombre no es válida.
RPC_S_UNSUPPORTED_NAME_SYNTAX
 No se admite la sintaxis de nombre.
RPC_S_INCOMPLETE_NAME
 El nombre está incompleto.
RPC_S_ENTRY_NOT_FOUND
 No se encontró la entrada name-service.
RPC_S_NAME_SERVICE_UNAVAILABLE
 El servicio de nombre no está disponible.
 
Nota Para obtener una lista de códigos de error válidos, vea rpc Return Values.
 

Observaciones

La función RpcNsProfileEltInqBegin crea un contexto de consulta para ver los elementos de un perfil.

Con el parámetro InquiryType, una aplicación especifica cuál de los siguientes elementos de perfil se van a devolver de llamadas a RpcNsProfileEltInqNext:

  • Elemento predeterminado
  • Todos los elementos
  • Elementos con la identificación de interfaz especificada
  • Elementos con el nombre de miembro especificado
  • Elementos con la identificación de interfaz y el nombre de miembro especificados
Antes de llamar a RpcNsProfileEltInqNext, la aplicación primero debe llamar a RpcNsProfileEltInqBegin para crear un contexto de consulta.

Cuando termine de ver los elementos de perfil, la aplicación llama a la función de RpcNsProfileEltInqDone para eliminar el contexto de consulta.

Nota Windows 2000 Active Directory admite esta función. Las versiones anteriores de Windows NT solo admiten el uso de esta función con cell Directory Service (CDS).
 

Nota

El encabezado rpcnsi.h define RpcNsProfileEltInqBegin como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito Valor
cliente mínimo admitido Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de rpcnsi.h (include Rpc.h)
biblioteca de Rpcns4.lib
DLL de Rpcns4.dll

Consulte también

RpcIfInqId

RpcNsProfileEltInqDone

RpcNsProfileEltInqNext