Funzione ADsGetObject (adshlp.h)
La funzione ADsGetObject viene associata a un oggetto in base al relativo percorso e a un identificatore di interfaccia specificato.
Sintassi
HRESULT ADsGetObject(
[in] LPCWSTR lpszPathName,
[in] REFIID riid,
[out] VOID **ppObject
);
Parametri
[in] lpszPathName
Tipo: LPCWSTR
Stringa Unicode con terminazione Null che specifica il percorso utilizzato per l'associazione all'oggetto nel servizio directory sottostante. Per altre informazioni ed esempi di codice per le stringhe di associazione per questo parametro, vedere LDAP ADsPath e WinNT ADsPath.
[in] riid
Tipo: REFIID
Identificatore di interfaccia per un'interfaccia specificata in questo oggetto.
[out] ppObject
Tipo: VOID**
Puntatore a un puntatore all'interfaccia richiesta.
Valore restituito
Tipo: HRESULT
Questo metodo supporta i valori restituiti HRESULT standard, nonché i seguenti.
Per altre informazioni sugli altri valori restituiti, vedere Codici di errore ADSI.
Commenti
Un client C/C++ chiama la funzione helper ADsGetObject per l'associazione a un oggetto ADSI. Equivale a un client Visual Basic che chiama la funzione GetObject . Entrambi accettano un ADsPath come input e restituiscono un puntatore all'interfaccia richiesta. Per impostazione predefinita, l'associazione usa ADS_SECURE_AUTHENTICATION'opzione con il contesto di sicurezza del thread chiamante. Tuttavia, se l'autenticazione non riesce, l'associazione sicura viene sottoposta a downgrade a un'associazione anonima, ad esempio un'associazione semplice senza credenziali utente. Per eseguire l'associazione sicura a un oggetto ADSI, usare la funzione ADsOpenObject anziché la funzione ADsGetObject .
Per un esempio di codice che illustra come usare ADsOpenObject, vedere Binding with GetObject e ADsGetObject.
È possibile eseguire il binding a un oggetto ADSI con credenziali utente diverse da quella dell'utente attualmente connesso. Per eseguire questa operazione, utilizzare la funzione ADsOpenObject .
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista |
| Server minimo supportato | Windows Server 2008 |
| Piattaforma di destinazione | Windows |
| Intestazione | adshlp.h |
| Libreria | Activeds.lib |
| DLL | Activeds.dll |