Función DrtStartSearch (drt.h)
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 |
---|---|
|
hDrt es un identificador no válido o phKeyRegistration es un identificador no válido. |
|
|
|
|
|
pInfo se pasó, pero dwSize de pInfo no es igual al tamaño de la estructura DRT_SEARCH_INFO . |
|
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. |
|
Los valores de clave mínima y máxima son iguales, pero el destino es diferente. |
|
La nube DRT está en estado defectuoso. |
|
El sistema está sin memoria. |
|
El DRT se está cerrando. |
|
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 |