Función DrtStartSearch (drt.h)

Artículo
08/23/2023

La función DrtStartSearch busca en drT una clave mediante criterios especificados en la estructura de DRT_SEARCH_INFO .

Sintaxis

HRESULT DrtStartSearch(
  [in]           HDRT                  hDrt,
  [in]           DRT_DATA              *pKey,
  [in, optional] const DRT_SEARCH_INFO *pInfo,
                 ULONG                 timeout,
  [in]           HANDLE                hEvent,
  [in, optional] const PVOID           pvContext,
  [out]          HDRT_SEARCH_CONTEXT   *hSearchContext
);

Parámetros

[in] hDrt

Identificador DRT devuelto por la función DrtOpen .

[in] pKey

Puntero a la estructura DRT_DATA que contiene la clave.

[in, optional] pInfo

Puntero a la estructura DRT_SEARCH_INFO que especifica las propiedades de la búsqueda.

timeout

Especifica los milisegundos hasta que se detiene la búsqueda.

[in] hEvent

Controle el evento que se señala cuando finaliza la API DrtStartSearch o se encuentra un nodo intermedio.

[in, optional] pvContext

Puntero a los datos de contexto pasados a la aplicación a través del evento .

[out] hSearchContext

Identificador usado en la llamada a DrtEndSearch.

Valor devuelto

Esta función devuelve S_OK si se ejecuta correctamente. Otros valores posibles son:

Código devuelto	Descripción
E_HANDLE	hDrt es un identificador no válido o phKeyRegistration es un identificador no válido.
E_INVALIDARG	hSearchContext es NULL. pKey es NULL El miembro pb de la estructura DRT_DATA de pKey es NULL. pInfo se pasó, la clave mínima se establece dentro de pInfo para la búsqueda de intervalos, pero la clave máxima es NULL. pInfo se pasó, la clave máxima se establece dentro de pInfo para la búsqueda de intervalos, pero la clave mínima es NULL.
DRT_E_INVALID_KEY_SIZE	El miembro cb de la estructura DRT_DATA de pKey no es igual a 256 bits. pInfo se pasó, pero el tamaño de clave del conjunto de claves mínimo dentro de pInfo no es igual a 256 bits. pInfo se pasó, pero el tamaño de clave del conjunto máximo de claves dentro de pInfo no es igual a 256 bits.
DRT_E_INVALID_SEARCH_INFO	pInfo se pasó, pero dwSize de pInfo no es igual al tamaño de la estructura DRT_SEARCH_INFO .
DRT_E_INVALID_MAX_ENDPOINTS	pInfo se pasó en pero el número máximo de puntos de conexión (cMaxEndpoints) se estableció en 0 dentro de pInfo o pInfo se pasó, pero cMaxEndpoints es mayor que 1 con fAnyMatchInRange establecido en TRUE.
DRT_E_INVALID_SEARCH_RANGE	Los valores de clave mínima y máxima son iguales, pero el destino es diferente.
DRT_E_FAULTED	La nube DRT está en estado defectuoso.
E_OUTOFMEMORY	El sistema está sin memoria.
E_UNEXPECTED	El DRT se está cerrando.
E_FAIL	Se ha producido un error irrecuperable inesperado.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	drt.h
Library	Drt.lib
Archivo DLL	Drt.dll

Consulte también