Partager via

IADsService, méthodes de propriété

  • Article

Les méthodes de propriété de l’interface IADsService lisent et écrivent les propriétés décrites dans cette rubrique. Pour plus d’informations, consultez Méthodes de propriété d’interface.

Propriétés

Dépendances

Tableau des noms BSTR des services ou groupes de charge qui doivent être chargés pour que ce service soit chargé. La syntaxe de l’entrée est « Service : » suivi du nom du service ou « Group: » suivi du nom du groupe de chargement.

Type d’accès : Lecture/écriture

Type de données de script : VARIANT

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

DisplayName

Nom convivial du service.

Type d’accès : Lecture/écriture

Type de données de script : BSTR

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

ErrorControl

Action à effectuer si ce service échoue au démarrage. Les valeurs suivantes sont valides pour cette propriété.

ADS_SERVICE_ERROR_IGNORE

Le programme de démarrage enregistre l’erreur, mais continue l’opération de démarrage.

ADS_SERVICE_ERROR_NORMAL

Le programme de démarrage enregistre l’erreur et présente une boîte de message, mais continue l’opération de démarrage.

ADS_SERVICE_ERROR_SEVERE

Le programme de démarrage enregistre l’erreur. Si la dernière configuration connue-bonne est démarrée, l’opération de démarrage se poursuit. Sinon, le système est redémarré avec la dernière configuration connue.

ADS_SERVICE_ERROR_CRITICAL

Si possible, le programme de démarrage enregistre l’erreur. Si la dernière configuration connue est en cours de démarrage, l’opération de démarrage échoue. Sinon, le système est redémarré avec la dernière bonne configuration connue.

Type d’accès : Lecture/écriture

Type de données de script : LONG

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

HostComputer

Chaîne ADsPath de l’hôte de ce service.

Type d’accès : Lecture/écriture

Type de données de script : BSTR

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

LoadOrderGroup

Nom du groupe d’ordre de chargement auquel ce service est membre.

Type d’accès : Lecture/écriture

Type de données de script : BSTR

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

Chemin d’accès

Chemin d’accès et nom de fichier de l’exécutable de ce service.

Type d’accès : Lecture/écriture

Type de données de script : BSTR

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

ServiceAccountName

Nom du compte que ce service utilise pour s’authentifier au démarrage.

Type d’accès : Lecture/écriture

Type de données de script : BSTR

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

ServiceAccountPath

Chemin du compte spécifié par la propriété ServiceAccountPath .

Type d’accès : Lecture/écriture

Type de données de script : BSTR

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

Servicetype

Description de la façon dont un service se présente sur l’ordinateur hôte. Cette propriété peut être égale à zéro ou à une combinaison d’une ou plusieurs des valeurs suivantes.

ADS_SERVICE_KERNEL_DRIVER (0x00000001)

ADS_SERVICE_FILE_SYSTEM_DRIVER (0x00000002)

ADS_SERVICE_OWN_PROCESS (0x00000010)

ADS_SERVICE_SHARE_PROCESS (0x00000020)

Type d’accès : Lecture/écriture

Type de données de script : LONG

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

Type de démarrage

Détermine comment démarrer le service. Les valeurs suivantes sont valides pour cette propriété.

ADS_SERVICE_BOOT_START

Le service est un pilote de périphérique démarré par le chargeur système. Cette valeur est uniquement valide pour les services de pilote.

ADS_SERVICE_SYSTEM_START

Le service est un pilote de périphérique démarré par la fonction IoInitSystem . Cette valeur est uniquement valide pour les services de pilote.

ADS_SERVICE_AUTO_START

Le service sera démarré automatiquement par le gestionnaire de contrôle de service lors du démarrage du système.

ADS_SERVICE_DEMAND_START

Le service est démarré par le gestionnaire de contrôle de service lorsqu’un processus appelle la fonction StartService .

ADS_SERVICE_DISABLED

Le service ne peut pas être démarré. Les tentatives de démarrage du service entraînent le code d’erreur ERROR_SERVICE_DISABLED.

Type d’accès : Lecture/écriture

Type de données de script : LONG

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

StartupParameters

Paramètres transmis au service au démarrage.

Type d’accès : Lecture/écriture

Type de données de script : BSTR

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

Version

Version du service.

Type d’accès : Lecture/écriture

Type de données de script : BSTR

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

Exemples

L’exemple de code suivant montre comment répertorier tous les services système disponibles s’exécutant sur l’ordinateur hôte, « myMachine », ainsi que l’emplacement où trouver les exécutables des services.

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

Spécifications

Condition requise Valeur
Client minimal pris en charge
 Windows Vista
Serveur minimal pris en charge
 Windows Server 2008
En-tête
Iads.h
DLL
Activeds.dll
IID
 IID_IADsService est défini comme 68AF66E0-31CA-11CF-A98A-00AA006BC149

Voir aussi

IADsService

Méthodes de propriété d’interface