Función RpcNsBindingLookupBeginA (rpcnsi.h)
La función RpcNsBindingLookupBegin crea un contexto de búsqueda para una interfaz y un objeto .
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 |
|---|---|
|
La llamada se realizó correctamente. |
|
La sintaxis del nombre no es válida. |
|
No se admite la sintaxis de nombre. |
|
El nombre está incompleto. |
|
No se encontró la entrada name-service. |
|
El nombre del servicio no está disponible. |
|
Objeto no válido. |
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.
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 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 |