Método IDsAdminCreateObj::CreateModal (dsadmin.h)
El método IDsAdminCreateObj::CreateModal muestra el asistente para la creación de objetos y devuelve el objeto recién creado. Se debe llamar al método IDsAdminCreateObj::Initialize antes de que se pueda llamar a IDsAdminCreateObj::CreateModal .
Sintaxis
HRESULT CreateModal(
[in] HWND hwndParent,
[out] IADs **ppADsObj
);
Parámetros
[in] hwndParent
Contiene el identificador de ventana del propietario del asistente. Este valor no puede ser NULL. Use el resultado de la función GetDesktopWindow si no hay ninguna ventana primaria disponible.
[out] ppADsObj
Puntero a un puntero de interfaz de IADs que recibe el objeto recién creado. Este parámetro recibe NULL si se produce un error en el Asistente para la creación de objetos o se cancela. El autor de la llamada debe liberar esta interfaz cuando ya no sea necesaria. Este parámetro puede ser NULL si este objeto no es necesario.
Valor devuelto
Este método puede devolver uno de estos valores.
Devuelve un código de error definido por OLE o uno de los valores siguientes.
Comentarios
Si el usuario cancela el Asistente para la creación de objetos, este método devuelve S_FALSE. Si ppADsObj no es NULL, ppADsObj recibe un valor NULL . Por este motivo, se debe evitar el uso de la macro SUCCEEDED para determinar si ppADsObj es válido. Pruebe siempre el contenido de ppADsObj para un valor distinto de NULL antes de usar el puntero de interfaz.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista |
| Servidor mínimo compatible | Windows Server 2008 |
| Plataforma de destino | Windows |
| Encabezado | dsadmin.h |
| Archivo DLL | DSAdmin.dll |