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

  • Artículo

Crea un objeto de configuración especificado por la ruta de acceso.

Sintaxis

HRESULT CreateSettingByPath(
  [in]  const WCHAR   *Path,
  [out] ISettingsItem **Setting
);

Parámetros

[in] Path

Puntero a la ruta de acceso.

[out] Setting

Puntero al elemento ISettingsItem recién creado.

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 que se llama al método para crear un elemento que no es un elemento de lista o que aún no existe.
WCM_E_READONLYITEM
 Indica que el elemento no se puede escribir, como si es un elemento de solo lectura o el espacio de nombres se abrió en modo ReadOnly.
WCM_E_INVALIDVALUE, WCM_E_INVALIDVALUEFORMAT o WCM_E_INVALIDDATATYPE
 Indica que el valor proporcionado para la clave no se puede convertir en el tipo adecuado, como un valor de cadena coerced a un entero sin signo.
WCM_E_WRONGESCAPESTRING
 Indica que la ruta de acceso contiene una secuencia de escape XML no reconocida.
WCM_E_INVALIDKEY
 Indica que la ruta de acceso se ha especificado incorrectamente y hace referencia a la clave incorrecta para un elemento de lista.

Comentarios

Nota Al crear un elemento de lista escalar, debe establecer un valor en el objeto ISettingsItem resultante antes de liberarlo o no se conservará.
 

Requisitos

   
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