Metodo IDsAdminCreateObj::CreateModal (dsadmin.h)
Il metodo IDsAdminCreateObj::CreateModal visualizza la creazione guidata dell'oggetto e restituisce l'oggetto appena creato. Il metodo IDsAdminCreateObj::Initialize deve essere chiamato prima che sia possibile chiamare IDAdminCreateObj::CreateModal .
Sintassi
HRESULT CreateModal(
[in] HWND hwndParent,
[out] IADs **ppADsObj
);
Parametri
[in] hwndParent
Contiene l'handle della finestra del proprietario della procedura guidata. Questo valore non può essere NULL. Usare il risultato della funzione GetDesktopWindow se non è disponibile alcuna finestra padre.
[out] ppADsObj
Puntatore a un puntatore dell'interfaccia IAD che riceve l'oggetto appena creato. Questo parametro riceve NULL se la creazione guidata dell'oggetto ha esito negativo o viene annullata. Il chiamante deve rilasciare questa interfaccia quando non è più necessaria. Questo parametro può essere NULL se questo oggetto non è obbligatorio.
Valore restituito
Questo metodo può restituire uno di questi valori.
Restituisce un codice di errore definito da OLE o uno dei valori seguenti.
Commenti
Se l'utente annulla la creazione guidata dell'oggetto, questo metodo restituisce S_FALSE. Se ppADsObj non è NULL, ppADsObj riceve un valore NULL . A causa di questo, è consigliabile evitare l'uso della macro SUCCEEDED per determinare se ppADsObj è valido. Testare sempre il contenuto di ppADsObj per un valore non NULL prima di usare il puntatore dell'interfaccia.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista |
| Server minimo supportato | Windows Server 2008 |
| Piattaforma di destinazione | Windows |
| Intestazione | dsadmin.h |
| DLL | DSAdmin.dll |