Método IWSManSession::Create (wsmandisp.h)

Crea una nueva instancia de un recurso y devuelve la referencia de punto de conexión (EPR) del nuevo objeto.

Sintaxis

HRESULT Create(
  [in]  VARIANT resourceUri,
  [in]  BSTR    resource,
  [in]  long    flags,
  [out] BSTR    *newUri
);

Parámetros

[in] resourceUri

Identificador del recurso que se va a crear.

Este parámetro puede contener uno de los siguientes elementos:

• URI con uno o varios selectores. Tenga en cuenta que el complemento WMI no admite la creación de ningún recurso que no sea un agente de escucha de protocolo WS-Management.
• Objeto ResourceLocator que puede contener selectores, fragmentos o opciones.
• Referencia del punto de conexión de WS-Addressing tal y como se describe en el estándar de protocolo WS-Management. Para obtener más información sobre la especificación pública del protocolo WS-Management, vea Página de índice de especificaciones de administración.

[in] resource

Cadena XML que contiene contenido de recursos.

[in] flags

Reservado. Se debe establecer en 0.

[out] newUri

EPR del nuevo recurso.

Valor devuelto

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

IWSManSession::Create solo se usa para crear nuevas instancias de un recurso. Use el método IWSManSession::P ut para actualizar las instancias existentes de un recurso. Después de obtener el nuevo URI de recurso, puede llamar a IWSManSession::Get para recuperar el nuevo objeto. El nuevo objeto contiene las propiedades que el proveedor de recursos asigna al crear el nuevo objeto. Por ejemplo, si crea un nuevoagente de escucha de protocolo WS-Management y recupera el objeto de escucha mediante Session.Get, también obtiene las propiedades Port, Enabled y ListeningOn .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Plataforma de destino	Windows
Encabezado	wsmandisp.h
Library	WSManDisp.tlb
Archivo DLL	WSMAuto.dll

Consulte también

IWSManSession

Session.Create