Funzione WdsCliFindFirstImage (wdsclientapi.h)

Articolo
03/19/2024

Avvia l'enumerazione delle immagini archiviate in un server WDS e restituisce un handle di ricerca che fa riferimento alla prima immagine.

Sintassi

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

Parametri

[in] hSession

Handle a una sessione con un server WDS. Questo è stato un handle restituito dalla funzione WdsCliCreateSession .

[out] phFindHandle

Puntatore a un valore HANDLE che riceve l'handle di ricerca. Se la funzione ha esito positivo, l'handle di ricerca farà riferimento alla prima immagine archiviata nel server WDS. Se la funzione ha esito negativo, questo parametro viene invariato. Usare la funzione WdsCliFindNextImage per avanzare il riferimento dell'handle find all'immagine successiva.

Nota Le informazioni sull'immagine possono essere ottenute solo dall'handle di ricerca usando le funzioni di informazioni sull'immagine dell'API client WDS.

Valore restituito

Se la funzione ha esito positivo, la restituzione è S_OK.

Commenti

La sessione deve essere autenticata per usare questa funzione. Per autenticare una sessione esistente, chiamare la funzione WdsCliAuthorizeSession .

L'immagine WDS trova handle restituita da questa funzione può essere usata con la funzione WdsCliFindNextImage per enumerare le immagini archiviate nel server WDS.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wdsclientapi.h
Libreria	WdsClientAPI.lib
DLL	WdsClientAPI.dll

Vedi anche

Funzioni client di Servizi di distribuzione Windows

Condividi tramite