Compartilhar via

Função CM_Is_Dock_Station_Present_Ex (cfgmgr32.h)

  • Artigo

[Começando com Windows 8 e Windows Server 2012, essa função foi preterida. Em vez disso, use CM_Is_Dock_Station_Present .]

A função CM_Is_Dock_Station_Present_Ex identifica se uma estação de encaixe está presente em um computador local ou remoto.

Sintaxe

CMAPI CONFIGRET CM_Is_Dock_Station_Present_Ex(
  [out]          PBOOL    pbPresent,
  [in, optional] HMACHINE hMachine
);

Parâmetros

[out] pbPresent

Ponteiro para um valor booliano que indica se uma estação de encaixe está presente em um computador local. A função define *pbPresent como TRUE se uma estação de encaixe estiver presente. A função define *pbPresent como FALSE se a função não puder se conectar ao computador especificado ou uma estação de encaixe não estiver presente.

[in, optional] hMachine

Fornece um identificador de computador retornado por CM_Connect_Machine.

Nota Não há suporte para o uso dessa função para acessar computadores remotos, começando com Windows 8 e Windows Server 2012, pois essa funcionalidade foi removida.
 

Retornar valor

Se a operação for bem-sucedida, a função retornará CR_SUCCESS. Caso contrário, a função retornará um dos códigos de erro prefixados por CR_ definidos em Cfgmgr32.h.

Comentários

Use essa função para determinar se uma estação de encaixe está presente em um computador local ou remoto. Você também pode usar as seguintes funções relacionadas com estações de encaixe:

  • CM_Is_Dock_Station_Present identifica se uma estação de encaixe está presente em um computador local.

  • CM_Request_Eject_PC solicita que um computador portátil, que é inserido em uma estação de encaixe local, seja ejetado.

  • CM_Request_Eject_PC_Ex solicita que um computador portátil, que é inserido em uma estação de encaixe local ou remota, seja ejetado.

A funcionalidade para acessar computadores remotos foi removida em Windows 8 e Windows Server 2012 e sistemas operacionais posteriores, portanto, você não pode acessar computadores remotos durante a execução nessas versões do Windows.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Microsoft Windows 2000 e versões posteriores do Windows.
Plataforma de Destino Área de Trabalho
Cabeçalho cfgmgr32.h (inclua Cfgmgr32.h)
Biblioteca Cfgmgr32.lib
DLL Cfgmgr32.dll

Confira também

CM_Is_Dock_Station_Present

CM_Request_Eject_PC

CM_Request_Eject_PC_Ex