Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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.
Hinweis Informationen zum Bild können nur mithilfe der Bildinformationsfunktionen der WDS-Client-API aus dem Suchhandle abgerufen werden.
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 |