Función RxPrefixTableLookupName (prefix.h)

RxPrefixTableLookupName busca un nombre en una tabla de prefijos usada para catalogar SRV_CALL, NET_ROOT y V_NET_ROOT nombres y convierte el puntero subyacente en una estructura que contiene el nombre.

Sintaxis

PVOID RxPrefixTableLookupName(
  [in]  IN PRX_PREFIX_TABLE  ThisTable,
  [in]  IN PUNICODE_STRING   CanonicalName,
  [out] OUT PUNICODE_STRING  RemainingName,
        IN PRX_CONNECTION_ID ConnectionId
);

Parámetros

[in] ThisTable

Puntero a la estructura RX_PREFIX_TABLE en la que se va a buscar.

[in] CanonicalName

Puntero al nombre de cadena Unicode que se va a buscar.

[out] RemainingName

Puntero al nombre de la cadena Unicode de la parte del nombre que no era coincidente.

ConnectionId

Parámetro opcional que representa un puntero al RX_CONNECTION_ID que se va a usar.

Valor devuelto

RxPrefixTableLookupName devuelve un puntero al nodo que se encontró si se encuentra una coincidencia. Si no se encuentra ninguna coincidencia, RxPrefixTableLookupName devuelve un puntero NULL.

Observaciones

RDBSS usa internamente esta rutina en respuesta a una llamada desde MUP para reclamar un nombre o formar la ruta de acceso de creación de una estructura de NET_ROOT o V_NET_ROOT. La rutina de RxPrefixTableLookupName también puede ser utilizada por los mini-redirectors de red siempre que se adquiera el bloqueo adecuado antes de acceder a la tabla y el bloqueo se libere cuando se complete el trabajo. El uso normal de un controlador sería el siguiente:

• Adquiera un bloqueo compartido llamando a RxpAcquirePrefixTableLockShared.
• Busque un nombre llamando a RxPrefixTableLookupName.
• Libere el bloqueo compartido llamando a RxpReleasePrefixTableLock.

Tenga en cuenta que si se encuentra una coincidencia, se incrementará el recuento de referencias en el nodo encontrado.

En las compilaciones activadas, RxPrefixTableLookupName hace que el sistema aserte si la longitud del canonicalName cadena no es mayor que cero.

Requisitos

Requisito	Valor
de la plataforma de destino de	Escritorio
encabezado de	prefix.h (include Prefix.h)
irQL	<= APC_LEVEL

Consulte también

RxpAcquirePrefixTableLockExclusive

rxpAcquirePrefixTableLockShared

RxpReleasePrefixTableLock