Metodi di proprietà IADsService

  • Articolo

I metodi di proprietà dell'interfaccia IADsService leggono e scrivono le proprietà descritte in questo argomento. Per altre informazioni, vedere Metodi di proprietà dell'interfaccia.

Proprietà

Dipendenze

Matrice di nomi BSTR di servizi o gruppi di carico che devono essere caricati per il caricamento di questo servizio. La sintassi per la voce è "Service:" seguita dal nome del servizio o "Group:" seguito dal nome del gruppo di caricamento.

Tipo di accesso: Lettura/scrittura

Tipo di dati di scripting: VARIANT

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

DisplayName

Nome descrittivo del servizio.

Tipo di accesso: Lettura/scrittura

Tipo di dati di scripting: BSTR

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

ErrorControl

Azione da eseguire se questo servizio ha esito negativo all'avvio. Di seguito sono riportati valori validi per questa proprietà.

ADS_SERVICE_ERROR_IGNORE

Il programma di avvio registra l'errore, ma continua l'operazione di avvio.

ADS_SERVICE_ERROR_NORMAL

Il programma di avvio registra l'errore e presenta una finestra di messaggio, ma continua l'operazione di avvio.

ADS_SERVICE_ERROR_SEVERE

Il programma di avvio registra l'errore. Se viene avviata l'ultima configurazione nota, l'operazione di avvio continua. In caso contrario, il sistema viene riavviato con l'ultima configurazione nota.

ADS_SERVICE_ERROR_CRITICAL

Il programma di avvio registra l'errore, se possibile. Se viene avviata l'ultima configurazione nota valida, l'operazione di avvio ha esito negativo. In caso contrario, il sistema viene riavviato con l'ultima configurazione valida nota.

Tipo di accesso: Lettura/scrittura

Tipo di dati di scripting: LONG

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

HostComputer

Stringa ADsPath dell'host di questo servizio.

Tipo di accesso: Lettura/scrittura

Tipo di dati di scripting: BSTR

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

LoadOrderGroup

Nome del gruppo di ordine di carico a cui il servizio è membro.

Tipo di accesso: Lettura/scrittura

Tipo di dati di scripting: BSTR

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

Percorso

Percorso e nome file all'eseguibile di questo servizio.

Tipo di accesso: Lettura/scrittura

Tipo di dati di scripting: BSTR

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

ServiceAccountName

Nome dell'account usato da questo servizio per autenticarsi all'avvio.

Tipo di accesso: Lettura/scrittura

Tipo di dati di scripting: BSTR

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

ServiceAccountPath

Percorso dell'account specificato dalla proprietà ServiceAccountPath .

Tipo di accesso: Lettura/scrittura

Tipo di dati di scripting: BSTR

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

ServiceType

Descrizione del modo in cui un servizio si presenta nel computer host. Questa proprietà può essere zero o una combinazione di uno o più dei valori seguenti.

ADS_SERVICE_KERNEL_DRIVER (0x00000001 )

ADS_SERVICE_FILE_SYSTEM_DRIVER (0x00000002 )

ADS_SERVICE_OWN_PROCESS (0x00000010 )

ADS_SERVICE_SHARE_PROCESS (0x00000020 )

Tipo di accesso: Lettura/scrittura

Tipo di dati di scripting: LONG

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

Tipo di avvio

Determina come avviare il servizio. Di seguito sono riportati valori validi per questa proprietà.

ADS_SERVICE_BOOT_START

Il servizio è un driver di dispositivo avviato dal caricatore di sistema. Questo valore è valido solo per i servizi del driver.

ADS_SERVICE_SYSTEM_START

Il servizio è un driver di dispositivo avviato dalla funzione IoInitSystem . Questo valore è valido solo per i servizi del driver.

ADS_SERVICE_AUTO_START

Il servizio verrà avviato automaticamente dal gestore del controllo del servizio durante l'avvio del sistema.

ADS_SERVICE_DEMAND_START

Il servizio verrà avviato dal gestore del controllo del servizio quando un processo chiama la funzione StartService .

ADS_SERVICE_DISABLED

Impossibile avviare il servizio. Tenta di avviare il servizio nel codice di errore ERROR_SERVICE_DISABLED.

Tipo di accesso: Lettura/scrittura

Tipo di dati di scripting: LONG

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

StartupParameters

Parametri passati al servizio all'avvio.

Tipo di accesso: Lettura/scrittura

Tipo di dati di scripting: BSTR

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

Versione

Versione del servizio.

Tipo di accesso: Lettura/scrittura

Tipo di dati di scripting: BSTR

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

Esempio

Nell'esempio di codice seguente viene illustrato come elencare tutti i servizi di sistema disponibili in esecuzione nel computer host, "myMachine", insieme al percorso per trovare i file eseguibili dei servizi.

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

Requisiti

Requisito Valore
Client minimo supportato
 Windows Vista
Server minimo supportato
 Windows Server 2008
Intestazione
Iads.h
DLL
Activeds.dll
IID
 IID_IADsService è definito come 68AF66E0-31CA-11CF-A98A-00AA006BC149

Vedi anche

IADsService

Metodi delle proprietà Interface