Compartilhar via

Métodos de propriedade IADsService

  • Artigo

Os métodos de propriedade da interface IADsService leem e gravam as propriedades descritas neste tópico. Para obter mais informações, consulte Métodos de propriedade de interface.

Propriedades

Dependências

Matriz de nomes BSTR de serviços ou grupos de carga que devem ser carregados para que esse serviço seja carregado. A sintaxe da entrada é "Service:" seguida pelo nome do serviço ou "Group:" seguido pelo nome do grupo de carga.

Tipo de acesso: leitura/gravação

Tipo de dados de script: VARIANT

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

DisplayName

O nome amigável do serviço.

Tipo de acesso: leitura/gravação

Tipo de dados de script: BSTR

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

ErrorControl

A ação a ser executada se esse serviço falhar na inicialização. Veja a seguir valores válidos para essa propriedade.

ADS_SERVICE_ERROR_IGNORE

O programa de inicialização registra o erro, mas continua a operação de inicialização.

ADS_SERVICE_ERROR_NORMAL

O programa de inicialização registra o erro e apresenta uma caixa de mensagem, mas continua a operação de inicialização.

ADS_SERVICE_ERROR_SEVERE

O programa de inicialização registra o erro. Se a última configuração conhecida e boa for iniciada, a operação de inicialização continuará. Caso contrário, o sistema será reiniciado com a configuração last-known-good.

ADS_SERVICE_ERROR_CRITICAL

O programa de inicialização registra o erro, se possível. Se a última configuração conhecida como boa estiver sendo iniciada, a operação de inicialização falhará. Caso contrário, o sistema será reiniciado com a última boa configuração conhecida.

Tipo de acesso: leitura/gravação

Tipo de dados de script: LONG

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

HostComputer

A cadeia de caracteres ADsPath do host desse serviço.

Tipo de acesso: leitura/gravação

Tipo de dados de script: BSTR

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

LoadOrderGroup

Nome do grupo de pedidos de carga que esse serviço é um membro.

Tipo de acesso: leitura/gravação

Tipo de dados de script: BSTR

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

Caminho

Caminho e nome de arquivo para o executável desse serviço.

Tipo de acesso: leitura/gravação

Tipo de dados de script: BSTR

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

ServiceAccountName

Nome da conta que esse serviço usa para se autenticar na inicialização.

Tipo de acesso: leitura/gravação

Tipo de dados de script: BSTR

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

ServiceAccountPath

Caminho da conta especificada pela propriedade ServiceAccountPath .

Tipo de acesso: leitura/gravação

Tipo de dados de script: BSTR

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

Servicetype

A descrição de como um serviço se apresenta no computador host. Essa propriedade pode ser zero ou uma combinação de um ou mais dos valores a seguir.

ADS_SERVICE_KERNEL_DRIVER (0x00000001)

ADS_SERVICE_FILE_SYSTEM_DRIVER (0x00000002)

ADS_SERVICE_OWN_PROCESS (0x00000010)

ADS_SERVICE_SHARE_PROCESS (0x00000020)

Tipo de acesso: leitura/gravação

Tipo de dados de script: LONG

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

StartType

Determina como iniciar o serviço. Veja a seguir valores válidos para essa propriedade.

ADS_SERVICE_BOOT_START

O serviço é um driver de dispositivo iniciado pelo carregador do sistema. Esse valor só é válido para serviços do driver.

ADS_SERVICE_SYSTEM_START

O serviço é um driver de dispositivo iniciado pela função IoInitSystem . Esse valor só é válido para serviços do driver.

ADS_SERVICE_AUTO_START

O serviço será iniciado automaticamente pelo gerenciador de controle de serviço durante a inicialização do sistema.

ADS_SERVICE_DEMAND_START

O serviço será iniciado pelo gerenciador de controle de serviço quando um processo chamar a função StartService .

ADS_SERVICE_DISABLED

Não é possível iniciar o serviço. Tentativas de iniciar o serviço resultam no código de erro ERROR_SERVICE_DISABLED.

Tipo de acesso: leitura/gravação

Tipo de dados de script: LONG

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

StartupParameters

Parâmetros passados para o serviço na inicialização.

Tipo de acesso: leitura/gravação

Tipo de dados de script: BSTR

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

Versão

Versão do serviço.

Tipo de acesso: leitura/gravação

Tipo de dados de script: BSTR

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

Exemplos

O exemplo de código a seguir mostra como listar todos os serviços de sistema disponíveis em execução no computador host, "myMachine", juntamente com o local para localizar os executáveis dos serviços.

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

Requisitos

Requisito Valor
Cliente mínimo com suporte
 Windows Vista
Servidor mínimo com suporte
 Windows Server 2008
Cabeçalho
Iads.h
DLL
Activeds.dll
IID
 IID_IADsService é definido como 68AF66E0-31CA-11CF-A98A-00AA006BC149

Confira também

IADsService

Métodos de propriedade de interface