Función NdisCoAssignInstanceName (ndis.h)

Artículo
08/07/2023

NdisCoAssignInstanceName asigna un nombre de instancia a una credencial verificable y hace que NDIS registre un GUID (identificador único global) para el nombre asignado con Instrumental de administración de Windows (WMI).

Sintaxis

NDIS_STATUS NdisCoAssignInstanceName(
  [in]            NDIS_HANDLE  NdisVcHandle,
  [in]            PNDIS_STRING BaseInstanceName,
  [out, optional] PNDIS_STRING VcInstanceName
);

Parámetros

[in] NdisVcHandle

Especifica el identificador para la credencial verificable a la que se llama. Este identificador lo proporcionó NDIS cuando la credencial verificable se creó originalmente con NdisCoCreateVc, ya sea por el cliente en preparación para realizar una llamada saliente o por el administrador de llamadas como preparación para enviar una llamada entrante al cliente.

[in] BaseInstanceName

Puntero a un tipo de NDIS_STRING que describe una cadena Unicode proporcionada por el autor de la llamada que especifica el nombre base del vc. El nombre base puede ser cualquier cadena Unicode localizable que identifique de forma única la credencial verificable con respecto a las demás máquinas virtuales con nombre dentro del ámbito del controlador de minipuerto. Para Windows Vista y versiones posteriores, NDIS define el tipo de NDIS_STRING como un tipo de UNICODE_STRING .

[out, optional] VcInstanceName

Puntero a un tipo de NDIS_STRING asignado por el autor de la llamada en el que esta rutina devuelve una cadena Unicode que especifica el nombre de instancia asignado por NDIS asignado para la credencial verificable.

Valor devuelto

NdisCoAssignInstanceName puede devolver cualquiera de las siguientes opciones:

Código devuelto	Descripción
NDIS_STATUS_SUCCESS	NDIS asignó un nombre de instancia al vc especificado y registró un GUID para el nombre de instancia con WMI.
NDIS_STATUS_FAILURE	Error al intentar asignar un nombre de instancia a la credencial verificable.
NDIS_STATUS_RESOURCES	NDIS no pudo asignar un búfer para el nombre de instancia.

Comentarios

Después de iniciar la configuración de una credencial verificable con NdisCoCreateVc, un administrador de llamadas o un cliente orientado a la conexión puede asignar un nombre a la credencial verificable con NdisCoAssignInstanceName. Al llamar a NdisCoAssignInstanceName, NDIS asigna a NDIS un nombre de instancia y registra el nombre de instancia con WMI. A continuación, los clientes WMI pueden enumerar la credencial verificable y consultar o establecer los identificadores de identificación en relación con la credencial verificable.

Un controlador integrado del administrador de llamadas de minipuerto (MCM) no puede usar NdisCoAssignInstanceName para asignar un nombre a sus máquinas virtuales. En su lugar, un controlador MCM debe crear un GUID personalizado y un OID para la credencial verificable y registrar la asignación GUID a OID con NDIS.

NDIS crea un nombre de instancia para la credencial verificable especificada anexando un índice al nombre base al que apunta el llamador. NDIS devuelve el nombre de instancia completo (nombre base + índice) al autor de la llamada y, a continuación, registra un GUID para el nombre de instancia con WMI. Solo los clientes WMI pueden enumerar y consultar las máquinas virtuales con nombre. Las máquinas virtuales sin nombre no son visibles para los clientes WMI.

Si la credencial verificable especificada ya tiene un nombre de instancia (asignado en una llamada anterior a NdisCoAssignInstanceName), NDIS devuelve NDIS_STATUS_SUCCESS y el nombre de instancia original asignado a la credencial verificable. Un nombre de instancia permanece asignado a una credencial verificable hasta que se elimina esa credencial verificable.

El llamador puede asociar el nombre de instancia devuelto con el identificador del VC con nombre que NDIS devolvió previamente al autor de la llamada desde NdisCoCreateVc. Sin embargo, NDIS seguirá usando el identificador vc,no el nombre de la instancia, para hacer referencia a la credencial verificable en llamadas posteriores. El autor de la llamada de NdisCoAssignInstanceName podría encontrar la necesidad de devolver el nombre de instancia a alguna otra entidad de administración.

El autor de la llamada es responsable de liberar el búfer que contiene el nombre de instancia devuelto. Después de eliminar el vc con nombre con NdisCoDeleteVc, el autor de la llamada debe liberar el búfer con NdisFreeString.

Requisitos

Requisito	Value
Cliente mínimo compatible	Compatible con los controladores NDIS 6.0 y NDIS 5.1 (consulte NdisCoAssignInstanceName (NDIS 5.1)) en Windows Vista. Compatible con los controladores NDIS 5.1 (consulta NdisCoAssignInstanceName (NDIS 5.1)) en Windows XP.
Plataforma de destino	Escritorio
Encabezado	ndis.h (incluya Ndis.h)
Library	Ndis.lib
IRQL	DISPATCH_LEVEL
Reglas de cumplimiento de DDI	Irql_Connection_Function(ndis)