DrtStartSearch, fonction (drt.h)
La fonction DrtStartSearch recherche une clé dans la DRT à l’aide de critères spécifiés dans la structure DRT_SEARCH_INFO .
Syntaxe
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
);
Paramètres
[in] hDrt
Handle DRT retourné par la fonction DrtOpen .
[in] pKey
Pointeur vers la structure DRT_DATA contenant la clé.
[in, optional] pInfo
Pointeur vers la structure DRT_SEARCH_INFO qui spécifie les propriétés de la recherche.
timeout
Spécifie les millisecondes jusqu’à l’arrêt de la recherche.
[in] hEvent
Gérez l’événement signalé lorsque l’API DrtStartSearch se termine ou qu’un nœud intermédiaire est trouvé.
[in, optional] pvContext
Pointeur vers les données de contexte passées à l’application via l’événement .
[out] hSearchContext
Handle utilisé dans l’appel à DrtEndSearch.
Valeur retournée
Cette fonction retourne S_OK en cas de réussite. D’autres valeurs possibles sont les suivantes :
Code de retour | Description |
---|---|
|
hDrt est un handle non valide ou phKeyRegistration est un handle non valide |
|
|
|
|
|
pInfo a été passé, mais le dwSize de pInfo n’est pas égal à la taille de la structure DRT_SEARCH_INFO . |
|
pInfo a été passé dans, mais le nombre maximal de points de terminaison (cMaxEndpoints) est défini sur 0 à l’intérieur de pInfo ou pInfo a été transmis, mais cMaxEndpoints est supérieur à 1 avec fAnyMatchInRange défini sur TRUE |
|
Les valeurs de clé minimale et maximale sont égales, mais la cible est différente. |
|
Le cloud DRT est à l’état défectueux. |
|
Le système est en mémoire insuffisante. |
|
La DRT s’arrête. |
|
Une erreur irrécupérable inattendue s’est produite. |
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Windows 7 Professionnel [applications de bureau uniquement] |
Serveur minimal pris en charge | Windows Server 2008 R2 [applications de bureau uniquement] |
Plateforme cible | Windows |
En-tête | drt.h |
Bibliothèque | Drt.lib |
DLL | Drt.dll |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour