Compartilhar via

Função WdsCliFindFirstImage (wdsclientapi.h)

  • Artigo

Inicia a enumeração de imagens armazenadas em um servidor WDS e retorna um identificador de localização que faz referência à primeira imagem.

Sintaxe

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

Parâmetros

[in] hSession

Um identificador para uma sessão com um servidor WDS. Esse foi um identificador retornado pela função WdsCliCreateSession .

[out] phFindHandle

Ponteiro para um valor HANDLE que recebe o identificador de localização. Se a função for bem-sucedida, o identificador de localização fará referência à primeira imagem armazenada no servidor WDS. Se a função não for bem-sucedida, esse parâmetro permanecerá inalterado. Use a função WdsCliFindNextImage para avançar a referência do identificador de localização para a próxima imagem.

Nota As informações sobre a imagem só podem ser obtidas do identificador de localização usando as funções de informações de imagem da API do cliente WDS.
 

Retornar valor

Se a função for bem-sucedida, o retorno será S_OK.

Comentários

A sessão deve ser autenticada para usar essa função. Para autenticar uma sessão existente, chame a função WdsCliAuthorizeSession .

O identificador de localização de imagem do WDS retornado por essa função pode ser usado com a função WdsCliFindNextImage para enumerar as imagens armazenadas no servidor WDS.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho wdsclientapi.h
Biblioteca WdsClientAPI.lib
DLL WdsClientAPI.dll

Confira também

Funções de cliente dos Serviços de Implantação do Windows