Partager via


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