Función RxPrefixTableLookupName (prefix.h)

RxPrefixTableLookupName busca un nombre en una tabla de prefijos que se usa 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 cadena Unicode de la parte del nombre sin coincidencia.

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 .

Comentarios

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 para una estructura de NET_ROOT o V_NET_ROOT. La rutina RxPrefixTableLookupName también puede ser utilizada por los miniireccionadores 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.

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

Requisitos

Consulte también

RxpAcquirePrefixTableLockExclusive

RxpAcquirePrefixTableLockShared

RxpReleasePrefixTableLock