Interfaz IBITSExtensionSetup (bitscfg.h)
Use la interfaz IBITSExtensionSetup para habilitar o deshabilitar las cargas de BITS en un directorio virtual.
Esta interfaz es una extensión ADSI. Para obtener un puntero a esta interfaz, llame a la función ADSI ADsGetObject como se muestra en Código de ejemplo.
Si usa esta interfaz desde un programa de instalación que también instala el servidor BITS, debe llamar al método IBITSExtensionSetupFactory::GetObject para obtener un puntero a esta interfaz en lugar de llamar a la función ADsGetObject .
Herencia
La interfaz IBITSExtensionSetup hereda de la interfaz IUnknown . IBITSExtensionSetup también tiene estos tipos de miembros:
Métodos
La interfaz IBITSExtensionSetup tiene estos métodos.
| IBITSExtensionSetup::D isableBITSUploads Use el método DisableBITSUploads para deshabilitar la carga de BITS en el directorio virtual al que apunta el objeto ADSI. Este método establece la propiedad de extensión DE IIS BITSUploadEnabled. |
| IBITSExtensionSetup::EnableBITSUploads Use el método EnableBITSUploads para habilitar la carga de BITS en el directorio virtual al que apunta el objeto ADSI. Este método establece la propiedad de extensión DE IIS BITSUploadEnabled. |
| IBITSExtensionSetup::GetCleanupTask Use el método GetCleanupTask para recuperar un puntero de interfaz a la tarea de limpieza asociada al directorio virtual. |
| IBITSExtensionSetup::GetCleanupTaskName Use el método GetCleanupTaskName para recuperar el nombre de la tarea de limpieza asociada al directorio virtual. |
Comentarios
Esta interfaz se registra en el servidor al instalar la extensión de servidor BITS.
En Windows Server 2003, use el Asistente para componentes de Windows para instalar la extensión de servidor BITS. En Panel de control, seleccione Agregar o quitar programas. A continuación, seleccione Agregar o quitar componentes de Windows para mostrar el Asistente para componentes de Windows. La extensión del servidor BITS es un subcomponente de Internet Information Services (IIS), que es un subcomponente del servidor de aplicaciones web.
Ejemplos
En el ejemplo siguiente se muestra cómo usar la función ADsGetObject para obtener un puntero a la interfaz IBITSExtensionSetup .
//Set the BITSUploadEnabled IIS configuration setting.
//The pszPath parameter contains the path to the directory service.
//For example, "IIS://<machine name>/w3svc/1/<virtual directory>".
//The Enable parameter contains true (enable) or false (disable).
HRESULT SetBITSUploadEnabledSetting(LPWSTR pszPath, bool Enable)
{
HRESULT hr;
IBITSExtensionSetup* pExtensionSetup = NULL;
hr = ADsGetObject(pszPath, __uuidof(IBITSExtensionSetup), &pExtensionSetup);
if (SUCCEEDED(hr))
{
if (Enable)
{
hr = pExtensionSetup->EnableBITSUploads();
}
else
{
hr = pExtensionSetup->DisableBITSUploads();
}
pExtensionSetup->Release();
}
return hr;
}
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista |
| Servidor mínimo compatible | Windows Server 2003 |
| Plataforma de destino | Windows |
| Encabezado | bitscfg.h |
| Redistribuible | BITS 1.5 en Windows XP |