Função WdsCliGetImageHalName (wdsclientapi.h)

Retorna o nome HAL (Camada de Abstração de Hardware) da imagem atual.

Sintaxe

HRESULT WDSCLIAPI WdsCliGetImageHalName(
  [in]  HANDLE hIfh,
  [out] PWSTR  *ppwszValue
);

Parâmetros

[in] hIfh

Um identificador de localização retornado pela função WdsCliFindFirstImage . A imagem referenciada pelo identificador de localização pode ser avançada usando a função WdsCliFindNextImage .

[out] ppwszValue

Um ponteiro para um ponteiro para um valor de cadeia de caracteres terminada em nulo que contém o nome HAL da imagem atual.

Valor retornado

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

Comentários

Esse valor é válido até que a função WdsCliFindNextImage ou WdsCliClose seja usada para alterar ou fechar o identificador atual.

Requisitos

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

WdsCliClose

WdsCliFindFirstImage

WdsCliFindNextImage

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