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 |