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 |