Función RpcNsMgmtBindingUnexportA (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 RpcNsMgmtBindingUnexportA(
  unsigned long EntryNameSyntax,
  RPC_CSTR      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 deben serexportados; solo los UUID de objeto deben no serexportados.

VersOption

Especifica cómo la función RpcNsMgmtBindingUnexport usa los miembros VersMajor y VersMinor de la estructura a la 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 aceptació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 en IfId.
RPC_C_VERS_IF_ID	Anula la aceptació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 aceptació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 aceptació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 aceptació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 ifId contenía V2.0 y la entrada de base de datos del servicio de nombres identificadores de enlace con las versiones 1.3, 2.0 y 2.1, la función RpcNsMgmtBindingUnexport dejaría deportar los identificadores 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 ningún UUID de objeto para anular la importación; solo los identificadores de enlace deben no serexportados.

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 del nombre no es válida.
RPC_S_UNSUPPORTED_NAME_SYNTAX	La sintaxis del nombre no es compatible.
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_INTERFACE_NOT_FOUND	No se ha encontrado la interfaz.
RPC_S_NOT_ALL_OBJS_UNEXPORTED	No todos los objetos no se han exportado.

 

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

 

Comentarios

La función RpcNsMgmtBindingUnexport permite que una aplicación de administración quite uno de los siguientes elementos de una entrada de 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 objetos 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 desexportarlos 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 aceptación de los UUID del objeto, si se especificó alguno.

Si se encuentran uno o varios identificadores de enlace para la interfaz especificada y no seportan sin errores, RpcNsMgmtBindingUnexporta cualquier UUID de objeto especificado. Si no se encontró alguno de los UUID del objeto especificado, 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 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 Las bases de datos de servicio de nombres están diseñadas para ser relativamente estables. En los servicios de nombres replicados, el uso frecuente de las funciones 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 neutro 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

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 (incluya Rpc.h)
Library	Rpcns4.lib
Archivo DLL	Rpcns4.dll

Consulte también

RpcMgmtEpUnregister

RpcNsBindingExport

RpcNsBindingUnexport