Методы свойств IADsService

Методы свойств интерфейса IADsService считывают и записывают свойства, описанные в этом разделе. Дополнительные сведения см. в разделе Методы свойств интерфейса.

Свойства

Зависимости

Массив BSTR-имен служб или групп загрузки, которые необходимо загрузить для загрузки этой службы. Для записи используется синтаксис Service:, за которым следует имя службы или Group:, за которым следует имя группы загрузки.

Тип доступа: чтение и запись

Тип данных скрипта: VARIANT

// C++ method syntax
HRESULT get_Dependencies(
  [out] VARIANT* pvServiceDepend
);
HRESULT put_Dependencies(
  [in] VARIANT vServiceDepend
);

Отображаемое имя

Понятное имя службы.

Тип доступа: чтение и запись

Тип данных скрипта: BSTR

// C++ method syntax
HRESULT get_DisplayName(
  [out] BSTR* pbstrDisplayName
);
HRESULT put_DisplayName(
  [in] BSTR bstrDisplayName
);

ErrorControl

Действие, выполняеме в случае сбоя этой службы при запуске. Ниже приведены допустимые значения для этого свойства.

ADS_SERVICE_ERROR_IGNORE

Программа запуска регистрирует ошибку, но продолжает операцию запуска.

ADS_SERVICE_ERROR_NORMAL

Программа запуска регистрирует ошибку и отображает окно сообщения, но продолжает операцию запуска.

ADS_SERVICE_ERROR_SEVERE

Программа запуска регистрирует ошибку. Если запущена последняя известная конфигурация, операция запуска продолжается. В противном случае система перезапускается с последней известной хорошей конфигурацией.

ADS_SERVICE_ERROR_CRITICAL

Программа запуска регистрирует ошибку, если это возможно. Если запускается последняя известная конфигурация, операция запуска завершается сбоем. В противном случае система перезапускается с последней известной хорошей конфигурацией.

Тип доступа: чтение и запись

Тип данных скрипта: LONG

// C++ method syntax
HRESULT get_ErrorControl(
  [out] LONG* plErrorControl
);
HRESULT put_ErrorControl(
  [in] LONG lErrorControl
);

HostComputer

Строка ADsPath узла этой службы.

Тип доступа: чтение и запись

Тип данных скрипта: BSTR

// C++ method syntax
HRESULT get_HostComputer(
  [out] BSTR* pbstrHostComputer
);
HRESULT put_HostComputer(
  [in] BSTR bstrHostComputer
);

LoadOrderGroup

Имя группы заказов на загрузку, членом которую является эта служба.

Тип доступа: чтение и запись

Тип данных скрипта: BSTR

// C++ method syntax
HRESULT get_LoadOrderGroup(
  [out] BSTR* pbstrLoadOrderGroup
);
HRESULT put_LoadOrderGroup(
  [in] BSTR bstrLoadOrderGroup
);

Путь

Путь и имя файла к исполняемому файлу этой службы.

Тип доступа: чтение и запись

Тип данных скрипта: BSTR

// C++ method syntax
HRESULT get_Path(
  [out] BSTR* pbstrPath
);
HRESULT put_Path(
  [in] BSTR bstrPath
);

ServiceAccountName

Имя учетной записи, которую эта служба использует для проверки подлинности при запуске.

Тип доступа: чтение и запись

Тип данных скрипта: BSTR

// C++ method syntax
HRESULT get_ServiceAccountName(
  [out] BSTR* pbstrServiceAccountName
);
HRESULT put_ServiceAccountName(
  [in] BSTR bstrServiceAccountName
);

ServiceAccountPath

Путь к учетной записи, указанной свойством ServiceAccountPath .

Тип доступа: чтение и запись

Тип данных скрипта: BSTR

// C++ method syntax
HRESULT get_ServiceAccountPath(
  [out] BSTR* pbstrServiceAccountPath
);
HRESULT put_ServiceAccountPath(
  [in] BSTR bstrServiceAccountPath
);

ServiceType

Описание представления службы на хост-компьютере. Это свойство может быть равно нулю или сочетанию одного или нескольких из следующих значений.

ADS_SERVICE_KERNEL_DRIVER (0x00000001)

ADS_SERVICE_FILE_SYSTEM_DRIVER (0x00000002)

ADS_SERVICE_OWN_PROCESS (0x00000010)

ADS_SERVICE_SHARE_PROCESS (0x00000020)

Тип доступа: чтение и запись

Тип данных скрипта: LONG

// C++ method syntax
HRESULT get_ServiceType(
  [out] LONG* plServiceType
);
HRESULT put_ServiceType(
  [in] LONG lServiceType
);

Тип запуска

Определяет, как запустить службу. Ниже приведены допустимые значения для этого свойства.

ADS_SERVICE_BOOT_START

Служба — это драйвер устройства, запущенный системным загрузчиком. Это значение допустимо только для служб драйверов.

ADS_SERVICE_SYSTEM_START

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

ADS_SERVICE_AUTO_START

Служба будет автоматически запущена диспетчером управления службами во время запуска системы.

ADS_SERVICE_DEMAND_START

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

ADS_SERVICE_DISABLED

Запуск службы невозможен. Попытки запустить службу приводят к ERROR_SERVICE_DISABLED кода ошибки.

Тип доступа: чтение и запись

Тип данных скрипта: LONG

// C++ method syntax
HRESULT get_StartType(
  [out] LONG* plStartType
);
HRESULT put_StartType(
  [in] LONG lStartType
);

StartupParameters

Параметры, передаваемые службе при запуске.

Тип доступа: чтение и запись

Тип данных скрипта: BSTR

// C++ method syntax
HRESULT get_StartupParameters(
  [out] BSTR* pbstrStartupParameters
);
HRESULT put_StartupParameters(
  [in] BSTR bstrStartupParameters
);

Версия

Версия службы.

Тип доступа: чтение и запись

Тип данных скрипта: BSTR

// C++ method syntax
HRESULT get_Version(
  [out] BSTR* pbstrVersion
);
HRESULT put_Version(
  [in] BSTR bstrVersion
);

Примеры

В следующем примере кода показано, как получить список всех доступных системных служб, работающих на хост-компьютере myMachine, а также расположение для поиска исполняемых файлов служб.

Dim cp As IADsComputer
On Error GoTo Cleanup

Set cp = GetObject("WinNT://myMachine,computer")
If (IsEmpty(cp) = False) Then
    cp.Filter = Array("Service")
    For Each service In cp
        MsgBox service.Name & " @" & service.path
    Next
End if

Cleanup:
    If (Err.Number<>0) Then
        MsgBox("An error has occurred. " & Err.Number)
    End If
    Set cp = Nothing

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Заголовок	Iads.h
DLL	Activeds.dll
IID	IID_IADsService определяется как 68AF66E0-31CA-11CF-A98A-00AA006BC149

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

IADsService

Методы свойств интерфейса