Función RpcNsBindingImportBeginA (rpcnsi.h)
La función RpcNsBindingImportBegin crea un contexto de importación para importar identificadores de enlace compatibles con el cliente para servidores que ofrecen la interfaz y el objeto especificados.
Sintaxis
RPC_STATUS RpcNsBindingImportBeginA(
unsigned long EntryNameSyntax,
RPC_CSTR EntryName,
RPC_IF_HANDLE IfSpec,
UUID *ObjUuid,
RPC_NS_HANDLE *ImportContext
);
Parámetros
EntryNameSyntax
Sintaxis de EntryName.
Para usar la sintaxis especificada en la entrada de valor del Registro HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntax, especifique RPC_C_NS_SYNTAX_DEFAULT.
EntryName
Puntero a un nombre de entrada en el que comienza la búsqueda de identificadores de enlace 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 de datos generada por código auxiliar que indica la interfaz que se va a importar. 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.
Cuando ObjUuid tiene un valor de puntero nulo o un UUID nulo, 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.
ImportContext
Identificador de servicio de nombres devuelto para su uso con las funciones RpcNsBindingImportNext y RpcNsBindingImportDone .
Valor devuelto
| Valor | Significado |
|---|---|
|
La llamada se realizó correctamente. |
|
La sintaxis del nombre no es válida. |
|
El nombre supera la longitud máxima. |
|
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
Antes de llamar a la función RpcNsBindingImportNext , la aplicación cliente primero debe llamar a RpcNsBindingImportBegin para crear un contexto de importación. Los parámetros de esta función controlan la operación de la función RpcNsBindingImportNext .
Cuando termine de importar identificadores de enlace, la aplicación cliente llama a la función RpcNsBindingImportDone para eliminar el contexto de importación.
Nota:
El encabezado rpcnsi.h define RpcNsBindingImportBegin 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
| 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 |