WdsCliFindFirstImage, fonction (wdsclientapi.h)

Démarre l’énumération des images stockées sur un serveur WDS et retourne un handle de recherche qui fait référence à la première image.

Syntaxe

HRESULT WDSCLIAPI WdsCliFindFirstImage(
  [in]  HANDLE  hSession,
  [out] PHANDLE phFindHandle
);

Paramètres

[in] hSession

Handle pour une session avec un serveur WDS. Il s’agissait d’un handle retourné par la fonction WdsCliCreateSession .

[out] phFindHandle

Pointeur vers une valeur HANDLE qui reçoit le handle de recherche. Si la fonction réussit, le handle de recherche référencera la première image stockée sur le serveur WDS. Si la fonction échoue, ce paramètre reste inchangé. Utilisez la fonction WdsCliFindNextImage pour avancer la référence du handle de recherche à l’image suivante.

Note Les informations sur l’image ne peuvent être obtenues qu’à partir du handle de recherche à l’aide des fonctions d’informations sur l’image de l’API client WDS.

 

Valeur retournée

Si la fonction réussit, le retour est S_OK.

Remarques

La session doit être authentifiée pour utiliser cette fonction. Pour authentifier une session existante, appelez la fonction WdsCliAuthorizeSession .

Le handle de recherche d’image WDS retourné par cette fonction peut être utilisé avec la fonction WdsCliFindNextImage pour énumérer les images stockées sur le serveur WDS.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	wdsclientapi.h
Bibliothèque	WdsClientAPI.lib
DLL	WdsClientAPI.dll

Voir aussi

Fonctions clientes des services de déploiement Windows