Función RpcNsMgmtBindingUnexportW (rpcnsi.h)

La función RpcNsMgmtBindingUnexport quita varios identificadores de enlace y objetos de una entrada en la base de datos name-service.

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

 

Sintaxis

RPC_STATUS RpcNsMgmtBindingUnexportW(
  unsigned long EntryNameSyntax,
  RPC_WSTR      EntryName,
  RPC_IF_ID     *IfId,
  unsigned long VersOption,
  UUID_VECTOR   *ObjectUuidVec
);

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, proporcione un valor de RPC_C_NS_SYNTAX_DEFAULT.

EntryName

Puntero al nombre de la entrada desde la que se van a quitar identificadores de enlace y UUID de objeto.

IfId

Puntero a una identificación de interfaz. Un valor de parámetro null indica que los identificadores de enlace no se van a exportar; solo los UUID de objeto deben ser noportados.

VersOption

Especifica cómo la función de RpcNsMgmtBindingUnexport usa el VersMajor y los miembros VersMinor de la estructura a los que apunta el parámetro IfId.

En la tabla siguiente se describen los valores válidos para el parámetro versOption .

Valores de VersOption	Significado
RPC_C_VERS_ALL	Anula la importación de todos los enlaces para el UUID de interfaz en IfId, independientemente de los números de versión. Para este valor, especifique 0 para las versiones principales y secundarias de IfId.
RPC_C_VERS_IF_ID	Anula la migración de los enlaces para el UUID de interfaz compatible en IfId con la misma versión principal y con una versión secundaria mayor o igual que la versión secundaria en IfId.
RPC_C_VERS_EXACT	Anula la migración de los enlaces para el UUID de interfaz en IfId con las mismas versiones principales y secundarias que en IfId.
RPC_C_VERS_MAJOR_ONLY	Anula la migración de los enlaces para el UUID de interfaz en IfId con la misma versión principal que en IfId (omite la versión secundaria). Para este valor, especifique 0 para la versión secundaria en IfId.
RPC_C_VERS_UPTO	Anula la portación de los enlaces que ofrecen una versión del UUID de interfaz especificado menor o igual que la versión principal y secundaria especificada. (Por ejemplo, si el IfId contenía V2.0 y la entrada de base de datos de servicio de nombres contenía identificadores de enlace con las versiones 1.3, 2.0 y 2.1, la función RpcNsMgmtBindingUnexport quitaría el control de enlace con las versiones 1.3 y 2.0).

ObjectUuidVec

Puntero a un vector de UUID de objeto que el servidor ya no quiere ofrecer. La aplicación construye este vector. Un valor NULL indica que no hay UUID de objeto que no se puedan exportar; solo se van a exportar los identificadores de enlace.

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 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_INTERFACE_NOT_FOUND	No se encontró la interfaz.
RPC_S_NOT_ALL_OBJS_UNEXPORTED	No todos los objetos no seportan.

 

Nota Para obtener una lista de códigos de error válidos, vea rpc Return Values.

 

Observaciones

La función rpcNsMgmtBindingUnexport permite que una aplicación de administración quite una de las siguientes entradas de una base de datos de servicio de nombre:

• Todos los identificadores de enlace para un UUID de interfaz especificado, calificado por los números de versión de la interfaz (principal y secundario)
• Uno o varios UUID de objeto de recursos
• Identificadores de enlace y UUID de objetos de recursos

Una aplicación de administración puede desexportar interfaces y objetos en una sola llamada a RpcNsMgmtBindingUnexport, o puede anular su ordenación por separado. Si RpcNsMgmtBindingUnexport no encuentra ningún identificador de enlace para la interfaz especificada, la función devuelve un código de estado de RPC_S_INTERFACE_NOT_FOUND y no anula la importación de los UUID de objeto, si se especificó alguno.

Si se encuentran uno o varios identificadores de enlace para la interfaz especificada y no se exportan sin error, RpcNsMgmtBindingUnexport noporta los UUID de objeto especificados. Si no se encontró alguno de los UUID de objeto especificados, RpcNsMgmtBindingUnexport devuelve RPC_S_NOT_ALL_OBJS_UNEXPORTED.

Además de llamar a RpcNsMgmtBindingUnexport, una aplicación de administración también debe llamar a la función de RpcMgmtEpUnregister para anular el registro de los servidores que se han registrado con la base de datos de mapa de puntos de conexión.

Nota bases de datos name-service están diseñadas para ser relativamente estables. En los servicios de nombres replicados, el uso frecuente de las funciones de RpcNsBindingExport y RpcNsBindingUnexport hace que el servicio de nombres quite repetidamente y reemplace la misma entrada, lo que puede causar problemas de rendimiento.

 

Nota

El encabezado rpcnsi.h define RpcNsMgmtBindingUnexport 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 Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	rpcnsi.h (include Rpc.h)
biblioteca de	Rpcns4.lib
DLL de	Rpcns4.dll

Consulte también

RpcMgmtEpUnregister

RpcNsBindingExport

RpcNsBindingUnexport