Función RpcNsBindingLookupBeginA (rpcnsi.h)

La función RpcNsBindingLookupBegin crea un contexto de búsqueda para una interfaz y un objeto .

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

Sintaxis

RPC_STATUS RpcNsBindingLookupBeginA(
  unsigned long EntryNameSyntax,
  RPC_CSTR      EntryName,
  RPC_IF_HANDLE IfSpec,
  UUID          *ObjUuid,
  unsigned long BindingMaxCount,
  RPC_NS_HANDLE *LookupContext
);

Parámetros

EntryNameSyntax

Sintaxis del parámetro EntryName .

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.

EntryName

Puntero a un nombre de entrada en el que comienza la búsqueda de enlaces compatibles.

Para usar el nombre de entrada especificado en la entrada de valor del Registro HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultEntry, proporcione un puntero nulo o una cadena vacía. En este caso, se omite el parámetro EntryNameSyntax y la biblioteca en tiempo de ejecución usa la sintaxis predeterminada.

IfSpec

Estructura generada por código auxiliar que indica la interfaz que se va a buscar. Si la especificación de la interfaz no se ha exportado o no se preocupa al autor de la llamada, especifique un valor NULL para este parámetro. En este caso, solo se garantiza que los enlaces devueltos sean de una secuencia de protocolo compatible y compatible y que contengan el UUID de objeto especificado. Es posible que el servidor contactado no admita la interfaz deseada.

ObjUuid

Puntero a un UUID de objeto opcional.

Para un UUID distinto de cero, los identificadores de enlace compatibles se devuelven desde una entrada solo si el servidor ha exportado el UUID de objeto especificado.

Para un valor de puntero nulo o un UUID nulo para este parámetro, los identificadores de enlace devueltos contienen uno de los UUID de objeto exportados por el servidor compatible. Si el servidor no exportó ningún UUID de objeto, los identificadores de enlace compatibles devueltos contienen un UUID de objeto nulo.

BindingMaxCount

Número máximo de enlaces que se devolverán en el parámetro BindingVec de la función RpcNsBindingLookupNext .

Especifique un valor de cero para usar el recuento predeterminado de RPC_C_BINDING_MAX_COUNT_DEFAULT.

LookupContext

Devuelve un puntero a un identificador de servicio de nombres para su uso con las funciones RpcNsBindingLookupNext y RpcNsBindingLookupDone .

Valor devuelto

Valor Significado
RPC_S_OK
La llamada se realizó correctamente.
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.
RPC_S_INVALID_OBJECT
Objeto no válido.
 
Nota Para obtener una lista de códigos de error válidos, vea Rpc Return Values.
 

Comentarios

La función RpcNsBindingLookupBegin crea un contexto de búsqueda para buscar identificadores de enlace compatibles con el cliente en servidores que ofrecen la interfaz y el objeto especificados.

Antes de llamar a RpcNsBindingLookupNext, la aplicación cliente primero debe llamar a RpcNsBindingLookupBegin para crear un contexto de búsqueda. Los parámetros de esta función controlan la operación de la función RpcNsBindingLookupNext .

Efectivo con Windows 2000, el entorno RPC usa Active Directory como su base de datos name-service y el orden en el que el entorno en tiempo de ejecución realiza la búsqueda es el siguiente:

  • Busque en la caché local.
  • Si no se encuentra la entrada en la caché local, busque en Active Directory de esa máquina.
  • Si no se encuentra la entrada en el equipo local, envíe solicitudes de difusión a todos los demás servicios de Active Directory del dominio.

    Tenga en cuenta que si la entrada existe en Active Directory, pero no hay información asociada a la entrada, el entorno en tiempo de ejecución no emitirá esta solicitud de difusión.

Cuando termine de localizar identificadores de enlace, la aplicación cliente llama a la función RpcNsBindingLookupDone para eliminar el contexto de búsqueda.

Nota

El encabezado rpcnsi.h define RpcNsBindingLookupBegin 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 provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

   
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

RpcNsBindingLookupDone

RpcNsBindingLookupNext