WdsCliFindFirstImage-Funktion (wdsclientapi.h)
Startet die Enumeration von Bildern, die auf einem WDS-Server gespeichert sind, und gibt ein Suchhandle zurück, das auf das erste Bild verweist.
Syntax
HRESULT WDSCLIAPI WdsCliFindFirstImage(
[in] HANDLE hSession,
[out] PHANDLE phFindHandle
);
Parameter
[in] hSession
Ein Handle für eine Sitzung mit einem WDS-Server. Dies war ein Handle, der von der WdsCliCreateSession-Funktion zurückgegeben wurde.
[out] phFindHandle
Zeiger auf einen HANDLE-Wert , der das Suchhandle empfängt. Wenn die Funktion erfolgreich ist, verweist das Suchhandle auf das erste Auf dem WDS-Server gespeicherte Bild. Wenn die Funktion nicht erfolgreich ist, bleibt dieser Parameter unverändert. Verwenden Sie die WdsCliFindNextImage-Funktion , um den Verweis des Suchhandles auf das nächste Bild weiter zu verwenden.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird die Rückgabe S_OK.
Hinweise
Die Sitzung muss authentifiziert werden, um diese Funktion verwenden zu können. Um eine vorhandene Sitzung zu authentifizieren, rufen Sie die WdsCliAuthorizeSession-Funktion auf.
Das von dieser Funktion zurückgegebene WDS-Bildsuchehandle kann mit der WdsCliFindNextImage-Funktion verwendet werden, um die auf dem WDS-Server gespeicherten Bilder aufzulisten.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | wdsclientapi.h |
| Bibliothek | WdsClientAPI.lib |
| DLL | WdsClientAPI.dll |