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

Cria uma nova instância de um recurso e retorna a EPR ( referência de ponto de extremidade ) do novo objeto.

Sintaxe

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

Parâmetros

[in] resourceUri

O identificador do recurso a ser criado.

Esse parâmetro pode conter um dos seguintes:

• URI com um ou mais seletores. Lembre-se de que o plug-in WMI não dá suporte à criação de nenhum recurso que não seja um ouvinte de protocolo WS-Management.
• Objeto ResourceLocator que pode conter seletores, fragmentos ou opções.
• Referência de ponto de extremidade de endereçamento WS, conforme descrito no padrão de protocolo WS-Management. Para obter mais informações sobre a especificação pública do protocolo WS-Management, consulte Página de índice de especificações de gerenciamento.

[in] resource

Uma cadeia de caracteres XML que contém o conteúdo do recurso.

[in] flags

Reservado. Deve ser definido como 0.

[out] newUri

A EPR do novo recurso.

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

IWSManSession::Create só é usado para criar novas instâncias de um recurso. Use o método IWSManSession::P ut para atualizar instâncias existentes de um recurso. Depois de obter o novo URI de recurso, você pode chamar IWSManSession::Get para recuperar o novo objeto. O novo objeto contém todas as propriedades que o provedor de recursos atribui ao criar o novo objeto. Por exemplo, se você criar um novoouvinte de protocolo WS-Management e recuperar o objeto ouvinte usando Session.Get, também obterá as propriedades Port, Enabled e ListeningOn .

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Plataforma de Destino	Windows
Cabeçalho	wsmandisp.h
Biblioteca	WSManDisp.tlb
DLL	WSMAuto.dll

Confira também

IWSManSession

Session.Create