Leer en inglés

Compartir a través de


Métodos de propiedad IADsService

Los métodos de propiedad de la interfaz IADsService leen y escriben las propiedades descritas en este tema. Para obtener más información, vea Métodos de propiedad de interfaz.

Propiedades

Dependencias

Matriz de nombres BSTR de servicios o grupos de carga que se deben cargar para que este servicio se cargue. La sintaxis de la entrada es "Service:" seguida del nombre del servicio o "Group:" seguido del nombre del grupo de carga.

Tipo de acceso: lectura/escritura

Tipo de datos de scripting: VARIANT

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

DisplayName

Nombre descriptivo del servicio.

Tipo de acceso: lectura/escritura

Tipo de datos de scripting: BSTR

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

ErrorControl

Acción que se va a realizar si se produce un error en este servicio al iniciarse. Los siguientes son valores válidos para esta propiedad.

ADS_SERVICE_ERROR_IGNORE

El programa de inicio registra el error, pero continúa la operación de inicio.

ADS_SERVICE_ERROR_NORMAL

El programa de inicio registra el error y presenta un cuadro de mensaje, pero continúa la operación de inicio.

ADS_SERVICE_ERROR_SEVERE

El programa de inicio registra el error. Si se inicia la última configuración correcta conocida, la operación de inicio continúa. De lo contrario, el sistema se reinicia con la última configuración correcta conocida.

ADS_SERVICE_ERROR_CRITICAL

El programa de inicio registra el error, si es posible. Si se está iniciando la última configuración correcta conocida, se produce un error en la operación de inicio. De lo contrario, el sistema se reinicia con la última configuración correcta conocida.

Tipo de acceso: lectura/escritura

Tipo de datos de scripting: LONG

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

HostComputer

Cadena ADsPath del host de este servicio.

Tipo de acceso: lectura/escritura

Tipo de datos de scripting: BSTR

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

LoadOrderGroup

Nombre del grupo de pedidos de carga al que pertenece este servicio.

Tipo de acceso: lectura/escritura

Tipo de datos de scripting: BSTR

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

Ruta de acceso

Ruta de acceso y nombre de archivo al archivo ejecutable de este servicio.

Tipo de acceso: lectura/escritura

Tipo de datos de scripting: BSTR

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

ServiceAccountName

Nombre de la cuenta que usa este servicio para autenticarse en el inicio.

Tipo de acceso: lectura/escritura

Tipo de datos de scripting: BSTR

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

ServiceAccountPath

Ruta de acceso de la cuenta especificada por la propiedad ServiceAccountPath .

Tipo de acceso: lectura/escritura

Tipo de datos de scripting: BSTR

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

ServiceType

Descripción de cómo se presenta un servicio en el equipo host. Esta propiedad puede ser cero o una combinación de uno o varios de los valores siguientes.

ADS_SERVICE_KERNEL_DRIVER (0x00000001)

ADS_SERVICE_FILE_SYSTEM_DRIVER (0x00000002)

ADS_SERVICE_OWN_PROCESS (0x00000010)

ADS_SERVICE_SHARE_PROCESS (0x00000020)

Tipo de acceso: lectura/escritura

Tipo de datos de scripting: LONG

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

StartType

Determina cómo iniciar el servicio. Los siguientes son valores válidos para esta propiedad.

ADS_SERVICE_BOOT_START

El servicio es un controlador de dispositivo iniciado por el cargador del sistema. Este valor solamente es válido para servicios de controladores.

ADS_SERVICE_SYSTEM_START

El servicio es un controlador de dispositivo iniciado por la función IoInitSystem . Este valor solamente es válido para servicios de controladores.

ADS_SERVICE_AUTO_START

El administrador de control de servicios iniciará automáticamente el servicio durante el inicio del sistema.

ADS_SERVICE_DEMAND_START

El administrador de control de servicios iniciará el servicio cuando un proceso llame a la función StartService .

ADS_SERVICE_DISABLED

No se puede iniciar el servicio. Los intentos de iniciar el servicio dan como resultado el código de error ERROR_SERVICE_DISABLED.

Tipo de acceso: lectura/escritura

Tipo de datos de scripting: LONG

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

StartupParameters

Parámetros pasados al servicio en el inicio.

Tipo de acceso: lectura/escritura

Tipo de datos de scripting: BSTR

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

Versión

Versión del servicio.

Tipo de acceso: lectura/escritura

Tipo de datos de scripting: BSTR

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

Ejemplos

En el ejemplo de código siguiente se muestra cómo enumerar todos los servicios del sistema disponibles que se ejecutan en el equipo host, "myMachine", junto con la ubicación para buscar los ejecutables de los servicios.

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 Value
Cliente mínimo compatible
Windows Vista
Servidor mínimo compatible
Windows Server 2008
Encabezado
Iads.h
Archivo DLL
Activeds.dll
IID
IID_IADsService se define como 68AF66E0-31CA-11CF-A98A-00AA006BC149

Consulte también

IADsService

Métodos de propiedad interface