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, VersOption y MemberName .
RPC_C_PROFILE_ALL_ELTS
 Devuelve todos los elementos del perfil. Se omiten los parámetros IfId, VersOption y 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, VersOption y MemberName .

IfId

Puntero a la identificación de la interfaz de los elementos de perfil que va a devolver la función 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 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 para 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 en IfId.
RPC_C_VERS_COMPATIBLE
 Devuelve los 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 los elementos de perfil que ofrecen la versión especificada del UUID de interfaz especificado.
RPC_C_VERS_MAJOR_ONLY
 Devuelve 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 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 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 MemberName y el parámetro devuelto 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 RpcNsProfileEltInqNext en los elementos de perfil. El parámetro MemberName 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, MemberName se omite y se puede especificar un valor NULL.

InquiryContext

Devuelve un puntero a un identificador de servicio de nombres para su uso con las funciones 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 del nombre no es válida.
RPC_S_UNSUPPORTED_NAME_SYNTAX
 La sintaxis del nombre no es compatible.
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 nombre del servicio no está disponible.
 
Nota Para obtener una lista de códigos de error válidos, consulte Rpc Return Values.
 

Comentarios

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

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

  • Elemento predeterminado
  • Todos los elementos
  • Elementos con la identificación de la 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 debe llamar primero a RpcNsProfileEltInqBegin para crear un contexto de consulta.

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

Nota Active Directory de Windows 2000 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 Convenciones para prototipos de función.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado rpcnsi.h (incluir Rpc.h)
Library Rpcns4.lib
Archivo DLL Rpcns4.dll

Consulte también

RpcIfInqId

RpcNsProfileEltInqDone

RpcNsProfileEltInqNext