Поделиться через


функция CM_Is_Dock_Station_Present_Ex (cfgmgr32.h)

[Начиная с Windows 8 и Windows Server 2012 эта функция устарела. Вместо этого используйте CM_Is_Dock_Station_Present .]

Функция CM_Is_Dock_Station_Present_Ex определяет, присутствует ли док-станция на локальном или удаленном компьютере.

Синтаксис

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

Параметры

[out] pbPresent

Указатель на логическое значение, указывающее, присутствует ли стыковочный узел на локальном компьютере. Функция задает параметру *pbPresent значение TRUE , если имеется стыковочный узел. Функция устанавливает для *pbPresentзначение FALSE , если функция не может подключиться к указанному компьютеру или отсутствует стыковочный узел.

[in, optional] hMachine

Предоставляет дескриптор компьютера, возвращаемый CM_Connect_Machine.

Примечание Использование этой функции для доступа к удаленным компьютерам не поддерживается, начиная с Windows 8 и Windows Server 2012, так как эта функция была удалена.
 

Возвращаемое значение

Если операция выполнена успешно, функция возвращает CR_SUCCESS. В противном случае функция возвращает один из кодов ошибок с префиксом CR_, определенных в Cfgmgr32.h.

Комментарии

Используйте эту функцию, чтобы определить, имеется ли стыковочный узел на локальном или удаленном компьютере. С док-станциями можно также использовать следующие связанные функции:

  • CM_Is_Dock_Station_Present определяет, присутствует ли док-станция на локальном компьютере.

  • CM_Request_Eject_PC запрашивает извлечение переносимого компьютера, который вставляется в локальную док-станцию.

  • CM_Request_Eject_PC_Ex запрашивает извлечение переносимого компьютера, который вставляется в локальную или удаленную док-станцию.

Функциональные возможности доступа к удаленным компьютерам были удалены в Windows 8 и Windows Server 2012 и более поздних версиях операционных систем, поэтому вы не сможете получить доступ к удаленным компьютерам при работе в этих версиях Windows.

Требования

Требование Значение
Минимальная версия клиента Доступно в Microsoft Windows 2000 и более поздних версиях Windows.
Целевая платформа Персональный компьютер
Верхняя часть cfgmgr32.h (включая Cfgmgr32.h)
Библиотека Cfgmgr32.lib
DLL Cfgmgr32.dll

См. также раздел

CM_Is_Dock_Station_Present

CM_Request_Eject_PC

CM_Request_Eject_PC_Ex