Función RpcNsBindingImportBeginA (rpcnsi.h)

  • Artículo

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.

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

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
RPC_S_OK
 La llamada se realizó correctamente.
RPC_S_INVALID_NAME_SYNTAX
 La sintaxis del nombre no es válida.
RPC_S_NAME_SERVICE_UNAVAILABLE
 El nombre supera la longitud máxima.
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 nombre del servicio no está disponible.
RPC_S_INVALID_OBJECT
 Objeto no válido.
 
Nota Para obtener una lista de códigos de error válidos, consulte Rpc Return Values.
 

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

Consulte también

RpcNsBindingImportDone

RpcNsBindingImportNext