Método ISettingsItem::RemoveSettingByPath (wcmconfig.h)

  • Artículo

Quita un objeto de configuración especificado por su ruta de acceso. A diferencia de GetSettingByPath, el uso de ISettingsItem::RemoveSettingByPath no se recomienda para los atributos.

Sintaxis

HRESULT RemoveSettingByPath(
  [in] const WCHAR *Path
);

Parámetros

[in] Path

Ruta de acceso del elemento que se va a quitar. La ruta de acceso es relativa al elemento actual.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto Descripción
S_OK
 Indica que se completó correctamente.
WCM_E_STATENODENOTFOUND
Indica un intento de quitar un elemento que no existe.
HRESULT_FROM_WIN32 (ERROR_INVALID_OPERATION)
 Indica un intento de quitar un elemento que no es un elemento de lista.
WCM_E_READONLYITEM
Indica que no se puede escribir el elemento, ya sea porque es un elemento de solo lectura o porque el espacio de nombres se abrió en modo ReadOnly.
WCM_E_WRONGESCAPESTRING
 Indica que la ruta de acceso contiene una secuencia de escape XML no reconocida.
WCM_E_INVALIDPATH
 Indica que la ruta de acceso tiene un formato incorrecto.
WCM_E_INVALIDKEY
Indica que la ruta de acceso se ha especificado incorrectamente y hace referencia a la clave incorrecta para el elemento de lista.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado wcmconfig.h
Archivo DLL SMIEngine.dll

Consulte también

ISettingsItem